@miller-tech/uap 1.0.0

package/dist/memory/ambiguity-detector.js

@@ -0,0 +1,401 @@
+/**
+ * Ambiguity Detection & Resolution System for UAP
+ *
+ * Implements P37: Ambiguity Detection pattern.
+ * Scores task instructions for ambiguity and generates clarifying questions
+ * when the score exceeds configurable thresholds.
+ *
+ * Ambiguity Levels:
+ * - score >= 0.6: MUST ask clarifying questions before execution
+ * - score 0.3-0.6: State assumptions explicitly, proceed with caution
+ * - score < 0.3: Execute directly (task is clear)
+ */
+// High ambiguity signals (weight: 0.3)
+const HIGH_AMBIGUITY_PATTERNS = [
+    {
+        pattern: /\b(it|that|this|the thing|the module|the component|the service)\b(?!\s+(is|was|has|should|will|can|must)\s+(a|an|the)\s+\w+)/i,
+        type: 'pronoun',
+        questionTemplate: 'You mentioned "{match}" — which specific {entity} are you referring to?',
+        defaultTemplate: "I'll target the most recently modified {entity}",
+    },
+    {
+        pattern: /\b(similar to|like before|the usual way|as we did|same as|like last time)\b/i,
+        type: 'relative_ref',
+        questionTemplate: 'You said "{match}" — can you specify which prior implementation or approach?',
+        defaultTemplate: "I'll follow the most common pattern in the codebase",
+    },
+    {
+        pattern: /\b(optimize|improve|fix|update|change|refactor|clean up|enhance)\b(?!\s+(the|this|that|my|our|a|an)\s+\w+\s+(in|at|of|from)\s)/i,
+        type: 'unspecified_target',
+        questionTemplate: 'You want to {match} — which specific file, module, or component should I target?',
+        defaultTemplate: "I'll analyze the codebase to identify the highest-impact target",
+    },
+    {
+        pattern: /\b(update the code|change the config|modify the settings|fix the tests|update the docs)\b/i,
+        type: 'missing_scope',
+        questionTemplate: 'Should "{match}" apply to all instances or a specific subset?',
+        defaultTemplate: "I'll apply changes to the most relevant files based on context",
+    },
+    {
+        pattern: /\b(fast\s+and\s+thorough|simple\s+and\s+comprehensive|quick\s+but\s+complete|minimal\s+but\s+full)\b/i,
+        type: 'contradiction',
+        questionTemplate: '"{match}" may involve trade-offs. Which aspect takes priority?',
+        defaultTemplate: "I'll prioritize correctness over speed",
+    },
+];
+// Medium ambiguity signals (weight: 0.2)
+const MEDIUM_AMBIGUITY_PATTERNS = [
+    {
+        pattern: /\b(obviously|of course|naturally|clearly|surely|everyone knows)\b/i,
+        type: 'implicit_assumption',
+        questionTemplate: 'You said "{match}" — can you confirm the specific assumption being made?',
+        defaultTemplate: "I'll verify the assumption against the codebase before proceeding",
+    },
+    {
+        pattern: /\b(some|a few|several|many|a couple|a bunch|various|multiple)\b\s+\w+/i,
+        type: 'vague_quantifier',
+        questionTemplate: 'How many specifically? You mentioned "{match}"',
+        defaultTemplate: "I'll handle a reasonable number based on context",
+    },
+    {
+        pattern: /\b(output|return|produce|generate|create)\s+(the\s+)?(results?|data|output|response)\b(?!\s+(to|in|as|into)\s)/i,
+        type: 'underspecified_format',
+        questionTemplate: 'What format should the output be in? (JSON, text, file, stdout, etc.)',
+        defaultTemplate: "I'll output in the format most consistent with existing code",
+    },
+    {
+        pattern: /\b(make it work|get it working|make sure it runs|should be good)\b/i,
+        type: 'missing_criteria',
+        questionTemplate: 'What specific success criteria should I verify? How do I know it\'s "working"?',
+        defaultTemplate: "I'll verify by running existing tests and checking for errors",
+    },
+];
+// Low ambiguity signals (weight: 0.1)
+const LOW_AMBIGUITY_PATTERNS = [
+    {
+        pattern: /\b(handle|deal with)\s+(errors?|exceptions?|failures?|edge cases?)\b/i,
+        type: 'error_handling',
+    },
+    {
+        pattern: /\b(style|format|convention|naming)\b/i,
+        type: 'style_unspecified',
+    },
+    {
+        pattern: /\b(edge case|corner case|boundary|limit|overflow|underflow)\b/i,
+        type: 'edge_case',
+    },
+];
+/**
+ * Detect ambiguity in a task instruction and generate clarifying questions.
+ *
+ * @param instruction - The task instruction to analyze
+ * @param projectContext - Optional project context for resolving domain terms
+ * @returns AmbiguityResult with score, signals, questions, and assumptions
+ */
+export function detectAmbiguity(instruction, projectContext) {
+    const signals = [];
+    let score = 0;
+    // Check high ambiguity patterns (0.3 each)
+    for (const { pattern, type, questionTemplate: _qt, defaultTemplate: _dt, } of HIGH_AMBIGUITY_PATTERNS) {
+        const match = instruction.match(pattern);
+        if (match) {
+            const weight = 0.3;
+            signals.push({
+                type,
+                weight,
+                match: match[0],
+                context: getMatchContext(instruction, match.index || 0),
+            });
+            score += weight;
+        }
+    }
+    // Check medium ambiguity patterns (0.2 each)
+    for (const { pattern, type } of MEDIUM_AMBIGUITY_PATTERNS) {
+        const match = instruction.match(pattern);
+        if (match) {
+            const weight = 0.2;
+            signals.push({
+                type,
+                weight,
+                match: match[0],
+                context: getMatchContext(instruction, match.index || 0),
+            });
+            score += weight;
+        }
+    }
+    // Check low ambiguity patterns (0.1 each)
+    for (const { pattern, type } of LOW_AMBIGUITY_PATTERNS) {
+        const match = instruction.match(pattern);
+        if (match) {
+            const weight = 0.1;
+            signals.push({
+                type,
+                weight,
+                match: match[0],
+                context: getMatchContext(instruction, match.index || 0),
+            });
+            score += weight;
+        }
+    }
+    // Structural ambiguity checks
+    score += checkStructuralAmbiguity(instruction, signals);
+    // Reduce ambiguity if project context resolves references
+    if (projectContext?.knownEntities) {
+        score = reduceWithContext(score, signals, projectContext.knownEntities);
+    }
+    // Cap score at 1.0
+    score = Math.min(1.0, score);
+    // Determine level
+    const level = score >= 0.6 ? 'high' : score >= 0.3 ? 'moderate' : 'clear';
+    // Generate questions for high/moderate ambiguity
+    const questions = generateQuestions(signals, instruction);
+    // Generate assumptions for moderate ambiguity
+    const assumptions = generateAssumptions(signals, instruction);
+    return {
+        score,
+        level,
+        signals,
+        questions: questions.slice(0, 5), // Max 5 questions per P37
+        assumptions,
+        shouldAsk: level === 'high',
+    };
+}
+/**
+ * Check structural ambiguity (instruction-level patterns)
+ */
+function checkStructuralAmbiguity(instruction, signals) {
+    let additionalScore = 0;
+    // Very short instructions are often ambiguous
+    const wordCount = instruction.split(/\s+/).length;
+    if (wordCount <= 3) {
+        signals.push({
+            type: 'missing_scope',
+            weight: 0.3,
+            match: instruction,
+            context: 'Very short instruction — likely missing details',
+        });
+        additionalScore += 0.3;
+    }
+    // No file paths or specific identifiers
+    const hasSpecificTarget = /[\w./\\-]+\.(ts|js|py|json|yaml|sh|sql|md|css|html)/i.test(instruction) ||
+        /\b(src|lib|test|config|scripts?)\//i.test(instruction);
+    if (!hasSpecificTarget && wordCount > 5) {
+        // Only flag if instruction is long enough to potentially need a target
+        const hasAction = /\b(fix|add|update|create|implement|refactor|optimize|remove|delete|change)\b/i.test(instruction);
+        if (hasAction) {
+            signals.push({
+                type: 'unspecified_target',
+                weight: 0.15,
+                match: 'no specific file/path mentioned',
+                context: 'Action verb present but no target file or path specified',
+            });
+            additionalScore += 0.15;
+        }
+    }
+    // Multiple action verbs suggest compound task
+    const actionVerbs = instruction.match(/\b(fix|add|update|create|implement|refactor|optimize|remove|delete|change|configure|setup|install|deploy|test|verify)\b/gi);
+    if (actionVerbs && actionVerbs.length >= 3) {
+        signals.push({
+            type: 'missing_scope',
+            weight: 0.15,
+            match: `${actionVerbs.length} action verbs: ${actionVerbs.slice(0, 3).join(', ')}...`,
+            context: 'Multiple actions requested — may need prioritization',
+        });
+        additionalScore += 0.15;
+    }
+    return additionalScore;
+}
+/**
+ * Reduce ambiguity score when project context resolves references
+ */
+function reduceWithContext(score, signals, knownEntities) {
+    let reduction = 0;
+    for (const signal of signals) {
+        // If a pronoun/reference matches a known entity, reduce its weight
+        if (signal.type === 'pronoun' || signal.type === 'relative_ref') {
+            const matchesEntity = knownEntities.some((entity) => signal.context.toLowerCase().includes(entity.toLowerCase()));
+            if (matchesEntity) {
+                reduction += signal.weight * 0.5; // Reduce by half
+            }
+        }
+    }
+    return Math.max(0, score - reduction);
+}
+/**
+ * Generate clarifying questions from ambiguity signals
+ */
+function generateQuestions(signals, instruction) {
+    const questions = [];
+    // Sort signals by weight (highest first = most important questions)
+    const sortedSignals = [...signals].sort((a, b) => b.weight - a.weight);
+    for (const signal of sortedSignals) {
+        const question = generateQuestionForSignal(signal, instruction);
+        if (question) {
+            questions.push(question);
+        }
+    }
+    return questions;
+}
+/**
+ * Generate a single clarifying question for an ambiguity signal
+ */
+function generateQuestionForSignal(signal, _instruction) {
+    const templates = {
+        pronoun: {
+            question: `You mentioned "${signal.match}" — which specific file, module, or component are you referring to?`,
+            default: "I'll target the most recently modified relevant file",
+            priority: 'blocking',
+        },
+        relative_ref: {
+            question: `You said "${signal.match}" — can you specify which prior implementation or approach you mean?`,
+            default: "I'll follow the most common pattern in the codebase",
+            priority: 'blocking',
+        },
+        unspecified_target: {
+            question: `You want to "${signal.match}" — which specific file or component should I target?`,
+            default: "I'll analyze the codebase to identify the highest-impact target",
+            priority: 'blocking',
+        },
+        missing_scope: {
+            question: `For "${signal.match}" — should this apply to all instances or a specific subset?`,
+            default: "I'll apply changes to the most relevant files based on context",
+            priority: 'important',
+        },
+        contradiction: {
+            question: `"${signal.match}" involves trade-offs. Which aspect takes priority?`,
+            default: "I'll prioritize correctness over speed",
+            priority: 'blocking',
+        },
+        implicit_assumption: {
+            question: `You said "${signal.match}" — can you confirm the specific assumption?`,
+            default: "I'll verify the assumption against the codebase",
+            priority: 'important',
+        },
+        vague_quantifier: {
+            question: `How many specifically? You mentioned "${signal.match}"`,
+            default: "I'll handle a reasonable number based on context",
+            priority: 'nice_to_know',
+        },
+        undefined_term: {
+            question: `Can you define "${signal.match}" in the context of this project?`,
+            default: "I'll use the standard industry definition",
+            priority: 'important',
+        },
+        missing_criteria: {
+            question: `What specific success criteria should I verify? How do I know "${signal.match}" is achieved?`,
+            default: "I'll verify by running existing tests and checking for errors",
+            priority: 'important',
+        },
+        underspecified_format: {
+            question: `What format should the output be in? (JSON, text, file, stdout, etc.)`,
+            default: "I'll output in the format most consistent with existing code",
+            priority: 'nice_to_know',
+        },
+        optional_unspecified: {
+            question: `Should I include optional parameters for "${signal.match}"?`,
+            default: "I'll use sensible defaults",
+            priority: 'nice_to_know',
+        },
+        style_unspecified: {
+            question: `Any specific style or formatting preferences for "${signal.match}"?`,
+            default: "I'll follow the existing project conventions",
+            priority: 'nice_to_know',
+        },
+        error_handling: {
+            question: `How should errors be handled for "${signal.match}"? (throw, log, retry, ignore)`,
+            default: "I'll throw errors for critical failures and log warnings for recoverable ones",
+            priority: 'nice_to_know',
+        },
+        edge_case: {
+            question: `Any specific edge cases to handle for "${signal.match}"?`,
+            default: "I'll handle common edge cases (null, empty, boundary values)",
+            priority: 'nice_to_know',
+        },
+    };
+    const template = templates[signal.type];
+    if (!template)
+        return null;
+    return {
+        question: template.question,
+        defaultAnswer: template.default,
+        priority: template.priority,
+        relatedSignal: signal,
+    };
+}
+/**
+ * Generate assumptions for moderate ambiguity (stated before proceeding)
+ */
+function generateAssumptions(signals, _instruction) {
+    const assumptions = [];
+    for (const signal of signals) {
+        switch (signal.type) {
+            case 'unspecified_target':
+                assumptions.push(`Assuming the target is the most relevant file based on codebase analysis`);
+                break;
+            case 'missing_scope':
+                assumptions.push(`Assuming changes should apply to the primary implementation, not tests or docs`);
+                break;
+            case 'error_handling':
+                assumptions.push(`Assuming standard error handling: throw on critical, log on recoverable`);
+                break;
+            case 'style_unspecified':
+                assumptions.push(`Following existing project conventions for style and formatting`);
+                break;
+            case 'edge_case':
+                assumptions.push(`Handling standard edge cases: null/undefined, empty collections, boundary values`);
+                break;
+            case 'underspecified_format':
+                assumptions.push(`Using the output format most consistent with existing code patterns`);
+                break;
+            case 'missing_criteria':
+                assumptions.push(`Success criteria: existing tests pass, no new errors, linter clean`);
+                break;
+        }
+    }
+    return [...new Set(assumptions)]; // Deduplicate
+}
+/**
+ * Get surrounding context for a match
+ */
+function getMatchContext(text, matchIndex) {
+    const start = Math.max(0, matchIndex - 30);
+    const end = Math.min(text.length, matchIndex + 50);
+    return text.slice(start, end).trim();
+}
+/**
+ * Format ambiguity result for injection into agent context
+ */
+export function formatAmbiguityForContext(result) {
+    if (result.level === 'clear')
+        return '';
+    const sections = [];
+    if (result.level === 'high') {
+        sections.push('## AMBIGUITY DETECTED — Clarification Needed');
+        sections.push(`Ambiguity score: ${result.score.toFixed(2)} (threshold: 0.6)`);
+        sections.push('');
+        sections.push('### Questions to resolve before proceeding:');
+        for (const q of result.questions.filter((q) => q.priority === 'blocking')) {
+            sections.push(`- **${q.question}**`);
+            sections.push(`  Default: ${q.defaultAnswer}`);
+        }
+        for (const q of result.questions.filter((q) => q.priority === 'important')) {
+            sections.push(`- ${q.question}`);
+            sections.push(`  Default: ${q.defaultAnswer}`);
+        }
+    }
+    else if (result.level === 'moderate') {
+        sections.push('## Assumptions (Moderate Ambiguity)');
+        sections.push(`Ambiguity score: ${result.score.toFixed(2)}`);
+        sections.push('');
+        sections.push('Proceeding with these assumptions:');
+        for (const assumption of result.assumptions) {
+            sections.push(`- ${assumption}`);
+        }
+    }
+    return sections.join('\n');
+}
+export default {
+    detectAmbiguity,
+    formatAmbiguityForContext,
+};
+//# sourceMappingURL=ambiguity-detector.js.map

package/dist/memory/ambiguity-detector.js.map

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

package/dist/memory/backends/base.d.ts

@@ -0,0 +1,18 @@
+export interface MemoryEntry {
+    id: string;
+    timestamp: string;
+    type: 'action' | 'observation' | 'thought' | 'goal' | 'lesson' | 'decision';
+    content: string;
+    embedding?: number[];
+    tags?: string[];
+    importance?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryBackend {
+    isConfigured(): Promise<boolean>;
+    store(entry: MemoryEntry): Promise<void>;
+    query(query: string, limit?: number): Promise<MemoryEntry[]>;
+    getRecent(limit?: number): Promise<MemoryEntry[]>;
+    prune(olderThan: Date): Promise<number>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/memory/backends/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/memory/backends/base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAE5B,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAGjC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAG7D,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAGlD,KAAK,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC"}

package/dist/memory/backends/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/memory/backends/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/memory/backends/base.ts"],"names":[],"mappings":""}

package/dist/memory/backends/factory.d.ts

@@ -0,0 +1,4 @@
+import type { AgentContextConfig } from '../../types/index.js';
+import type { MemoryBackend } from './base.js';
+export declare function createMemoryBackend(config: AgentContextConfig): Promise<MemoryBackend | null>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/memory/backends/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/memory/backends/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/C,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuDnG"}

package/dist/memory/backends/factory.js

@@ -0,0 +1,53 @@
+import { GitHubMemoryBackend } from './github.js';
+import { QdrantCloudBackend } from './qdrant-cloud.js';
+export async function createMemoryBackend(config) {
+    if (!config.memory?.longTerm?.enabled) {
+        return null;
+    }
+    const longTerm = config.memory.longTerm;
+    // Check GitHub backend (opt-in via config or env vars)
+    if (longTerm.github?.enabled) {
+        const token = longTerm.github.token || process.env.GITHUB_TOKEN;
+        const repo = longTerm.github.repo;
+        if (token && repo) {
+            try {
+                const backend = new GitHubMemoryBackend({
+                    token,
+                    repo,
+                    path: longTerm.github.path || '.uap/memory',
+                    branch: longTerm.github.branch || 'main',
+                });
+                if (await backend.isConfigured()) {
+                    return backend;
+                }
+            }
+            catch (error) {
+                console.warn(`GitHub backend not available: ${error}`);
+            }
+        }
+    }
+    // Check Qdrant Cloud backend (opt-in via config or env vars)
+    if (longTerm.qdrantCloud?.enabled) {
+        const apiKey = longTerm.qdrantCloud.apiKey || process.env.QDRANT_API_KEY;
+        const url = longTerm.qdrantCloud.url || process.env.QDRANT_URL;
+        if (apiKey && url) {
+            try {
+                const backend = new QdrantCloudBackend({
+                    url,
+                    apiKey,
+                    collection: longTerm.qdrantCloud.collection || 'agent_memory',
+                    projectId: config.project?.name || process.cwd(),
+                });
+                if (await backend.isConfigured()) {
+                    return backend;
+                }
+            }
+            catch (error) {
+                console.warn(`Qdrant Cloud backend not available: ${error}`);
+            }
+        }
+    }
+    // No configured backend found - gracefully return null
+    return null;
+}
+//# sourceMappingURL=factory.js.map

package/dist/memory/backends/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/memory/backends/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA0B;IAClE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IAExC,uDAAuD;IACvD,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAElC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC;oBACtC,KAAK;oBACL,IAAI;oBACJ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,aAAa;oBAC3C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM;iBACzC,CAAC,CAAC;gBAEH,IAAI,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,IAAI,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACzE,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAE/D,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC;oBACrC,GAAG;oBACH,MAAM;oBACN,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,UAAU,IAAI,cAAc;oBAC7D,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE;iBACjD,CAAC,CAAC;gBAEH,IAAI,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/memory/backends/github.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryBackend, MemoryEntry } from './base.js';
+interface GitHubMemoryBackendConfig {
+    token: string;
+    repo: string;
+    path: string;
+    branch: string;
+}
+export declare class GitHubMemoryBackend implements MemoryBackend {
+    private octokit;
+    private repo;
+    private owner;
+    private path;
+    private branch;
+    constructor(config: GitHubMemoryBackendConfig);
+    isConfigured(): Promise<boolean>;
+    store(entry: MemoryEntry): Promise<void>;
+    /**
+     * Query memories by substring match (case-insensitive).
+     * Note: This is NOT semantic search — it uses simple string containment.
+     * For semantic search, use QdrantCloudBackend instead.
+     */
+    query(query: string, limit?: number): Promise<MemoryEntry[]>;
+    getRecent(limit?: number): Promise<MemoryEntry[]>;
+    prune(olderThan: Date): Promise<number>;
+}
+export {};
+//# sourceMappingURL=github.d.ts.map

package/dist/memory/backends/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/memory/backends/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5D,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,yBAAyB;IAWvC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOxD,SAAS,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoC7C,KAAK,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CA4C9C"}