opcode-pg-memory 2.2.0

package/dist/src/mcp/hindsight-reflect.d.ts

@@ -0,0 +1,75 @@
+import { Pool } from 'pg';
+import type { Reflection } from '../types';
+export interface HindsightReflectInput {
+    session_id?: string;
+    omo_task_id?: string;
+    topic_segment_id?: string;
+    trigger_type?: 'manual' | 'threshold' | 'scheduled';
+    model_size?: '7b' | '14b' | 'full';
+    aggregate?: boolean;
+    /** @deprecated Backward compat — threshold is now in HindsightReflectConfig */
+    observation_threshold?: number;
+}
+export interface HindsightReflectOutput {
+    generated_reflections: Reflection[];
+    token_usage: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    duration_ms: number;
+}
+export interface HindsightReflectConfig {
+    observationThreshold: number;
+    segmentThreshold: number;
+    minThreshold: number;
+    maxThreshold: number;
+    modelSize: '7b' | '14b' | 'full';
+    offPeakHours: number[];
+    minConfidence: number;
+    /** Max observations to fetch per segment */
+    maxObservationsPerSegment: number;
+    /** Max observations to fetch in aggregate mode */
+    maxObservationsAggregate: number;
+    /** Batch size for LLM reflection calls */
+    reflectionBatchSize: number;
+    /** Prompts used for LLM reflection — configurable to avoid hardcoding */
+    prompts: {
+        systemPrompt: string;
+        perSegmentUserPrompt: string;
+        aggregateUserPrompt: string;
+    };
+}
+export declare const DEFAULT_REFLECTION_SYSTEM_PROMPT = "You are a reflection engine that analyzes coding session observations to extract reusable patterns and insights.\n\n## Task\nAnalyze the provided observations from a coding session and generate structured reflections that capture:\n1. Error patterns and their root causes\n2. Successful approaches and best practices\n3. User preferences and coding style\n4. Technical stack patterns\n5. Cross-session applicable insights\n\n## Input Format\nObservations will be provided as a JSON array with fields:\n- id: Observation identifier\n- tool_name: The tool that was used\n- tool_input_summary: Summary of inputs\n- tool_output_summary: Summary of outputs\n- importance: Importance rating (1-5)\n- created_at: Timestamp\n- metadata: Additional metadata\n\n## Output Format\nRespond with a JSON object containing:\n{\n  \"summary\": \"High-level summary of the session insights (2-3 sentences)\",\n  \"patterns\": [\n    {\n      \"pattern_type\": \"error_pattern|success_pattern|preference|technical_stack|workflow|tool_preference|insight\",\n      \"description\": \"Detailed description of the pattern (1-2 sentences)\",\n      \"confidence\": 0.0-1.0,\n      \"source_observation_ids\": [\"id1\", \"id2\"],\n      \"applicability\": \"When this pattern applies\"\n    }\n  ],\n  \"recommendations\": [\n    \"Actionable recommendation based on patterns\"\n  ],\n  \"technical_stack\": {\n    \"languages\": [\"detected languages\"],\n    \"frameworks\": [\"detected frameworks\"],\n    \"tools\": [\"frequently used tools\"]\n  }\n}\n\n## Rules\n- Only include patterns with confidence >= 0.6\n- Focus on cross-session applicable insights\n- Be specific about technical details (file names, function names, etc.)\n- Avoid generic advice like \"write clean code\"\n- Consider the sequence of observations for causal relationships\n- Identify recurring errors and their solutions\n- Note user preferences (indentation style, naming conventions, etc.)\n\n## Pattern Types\n- error_pattern: Recurring errors and how they were resolved\n- success_pattern: Approaches that worked well\n- preference: User's coding style and preferences\n- technical_stack: Technologies and tools used\n- workflow: Development workflow patterns\n- tool_preference: Frequently used tools and preferences\n- insight: Notable technical discoveries or lessons";
+export declare const DEFAULT_PER_SEGMENT_USER_PROMPT = "You are a technical retrospective assistant. Analyze the following tool execution records from topic: \"{topic_summary}\", and summarize:\n1. Recurring patterns or workflows\n2. Notable technical discoveries or lessons\n3. Recommendations for future similar tasks\n\nSession context: {session_context}\n\nObservations:\n{observations_json}";
+export declare const DEFAULT_AGGREGATE_USER_PROMPT = "You are a technical retrospective assistant. Analyze the following tool execution records across multiple topics and sessions, and summarize:\n1. Cross-topic recurring patterns or workflows\n2. Notable technical discoveries or lessons that span topics\n3. Recommendations for future similar tasks\n\nTopics covered: {topics_summary}\n\nObservations:\n{observations_json}";
+/**
+ * Enhanced hindsight_reflect with topic_segment-based reflection,
+ * omo_task_id support, and aggregate mode.
+ *
+ * Scope resolution:
+ * 1. topic_segment_id → reflect on that single segment
+ * 2. session_id + aggregate=false → group by topic_segment, reflect per segment
+ * 3. session_id + aggregate=true → reflect on all observations across all segments
+ * 4. omo_task_id → find all session_map entries for this task, reflect across their segments
+ *
+ * Backward compatible: session_id-only input falls back to legacy path
+ * (sessions table + session-scoped reflection).
+ */
+export declare function hindsightReflect(input: HindsightReflectInput, pool: Pool, config?: Partial<HindsightReflectConfig>): Promise<HindsightReflectOutput>;
+/**
+ * 检查是否是低峰期
+ */
+export declare function isOffPeakHour(config?: {
+    offPeakHours: number[];
+}): boolean;
+/**
+ * 获取反思统计
+ */
+export declare function getReflectionStats(sessionId: string, pool: Pool): Promise<{
+    totalReflections: number;
+    patternTypes: Record<string, number>;
+    averageConfidence: number;
+    lastReflectionAt: Date | null;
+}>;
+//# sourceMappingURL=hindsight-reflect.d.ts.map

package/dist/src/mcp/hindsight-reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hindsight-reflect.d.ts","sourceRoot":"","sources":["../../../src/mcp/hindsight-reflect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IACpD,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,UAAU,EAAE,CAAC;IACpC,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,yBAAyB,EAAE,MAAM,CAAC;IAClC,kDAAkD;IAClD,wBAAwB,EAAE,MAAM,CAAC;IACjC,0CAA0C;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAOD,eAAO,MAAM,gCAAgC,+xEA2DO,CAAC;AAErD,eAAO,MAAM,+BAA+B,wVAQxB,CAAC;AAErB,eAAO,MAAM,6BAA6B,uXAQtB,CAAC;AAwBrB;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CA+GjC;AAg4BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAI1E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IACT,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B,CAAC,CAwCD"}

package/dist/src/mcp/recall-memory-omo.d.ts

@@ -0,0 +1,47 @@
+/**
+ * recall_memory MCP 工具 - OmO 适配版本
+ *
+ * 针对 Oh My OpenAgent 多 Agent 环境优化的记忆检索工具
+ * 支持 Agent 隔离、父子 Agent 继承、OmO Wisdom 集成
+ */
+import { Pool } from 'pg';
+import { RecallMemoryInput, RecallMemoryOutput } from './recall-memory';
+export interface RecallMemoryOmOInput extends RecallMemoryInput {
+    agent_id: string;
+    task_id?: string;
+    parent_agent_id?: string;
+    agent_scope?: 'self' | 'siblings' | 'parent' | 'children' | 'all';
+    include_omo_wisdom?: boolean;
+    omo_context_budget?: number;
+    coordination_mode?: 'omo-first' | 'equal' | 'memory-first';
+}
+export interface RecallMemoryOmOOutput extends RecallMemoryOutput {
+    agent_id: string;
+    task_id?: string;
+    source_distribution: {
+        own_agent: number;
+        sibling_agents: number;
+        parent_agent: number;
+        child_agents: number;
+        shared_knowledge: number;
+        omo_wisdom?: number;
+    };
+    token_budget_usage: {
+        allocated: number;
+        used: number;
+        omo_reserved: number;
+        remaining: number;
+    };
+    coordination_applied: boolean;
+}
+/**
+ * OmO 版本的 recall_memory 工具
+ *
+ * 主要差异：
+ * 1. 支持 Agent 隔离和范围过滤
+ * 2. 与 OmO Token 预算协调
+ * 3. 可选集成 OmO Wisdom
+ * 4. 详细的来源分布统计
+ */
+export declare function recallMemoryOmO(input: RecallMemoryOmOInput, pool: Pool): Promise<RecallMemoryOmOOutput>;
+//# sourceMappingURL=recall-memory-omo.d.ts.map

package/dist/src/mcp/recall-memory-omo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-memory-omo.d.ts","sourceRoot":"","sources":["../../../src/mcp/recall-memory-omo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAgB,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAE7D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IAGlE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,cAAc,CAAC;CAC5D;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAE/D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAGF,kBAAkB,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,qBAAqB,CAAC,CAmFhC"}

package/dist/src/mcp/recall-memory.d.ts

@@ -0,0 +1,89 @@
+import { Pool } from 'pg';
+export interface RecallMemoryInput {
+    /** The search query text */
+    query: string;
+    /** OpenCode session external ID. Auto-detected as most recent active session if omitted. */
+    session_id?: string;
+    /** OmO task ID for agent-scoped retrieval */
+    omo_task_id?: string;
+    /** Specific topic segment to bias toward (ignored if caller_context.current_session_id is set) */
+    topic_segment_id?: string;
+    /** Caller metadata for topic-context fusion and agent-aware retrieval */
+    caller_context?: {
+        type: 'user' | 'omo_agent';
+        current_goal?: string;
+        current_session_id?: string;
+    };
+    /** Retrieval strategies to execute in parallel. Default: ['semantic', 'bm25', 'graph'] */
+    retrieval_strategies?: Array<'semantic' | 'bm25' | 'graph' | 'keyword' | 'temporal'>;
+    /** Max results to return. Default: 10 */
+    max_results?: number;
+    /** Filters applied post-retrieval */
+    filters?: {
+        min_confidence?: number;
+        min_importance?: number;
+        /** Single tier filter */
+        tier?: 'permanent' | 'project' | 'session';
+        /** Backward compat: array of tier levels (maps to tier for single value) */
+        tier_levels?: Array<'permanent' | 'project' | 'session'>;
+        entity_types?: string[];
+        exclude_topic_segment_ids?: string[];
+        /** Time range in days (backward compat) */
+        time_range_days?: number;
+    };
+    /** Cross-encoder rerank (backward compat). Default: true */
+    rerank?: boolean;
+}
+export interface MemoryResult {
+    id: string;
+    type: 'entity' | 'observation' | 'reflection' | 'relation';
+    /** Structured data payload for the new interface */
+    data: Record<string, any>;
+    relevance_score: number;
+    /** Full context metadata */
+    context: {
+        session_id: string;
+        omo_task_id?: string;
+        topic_segment_id: string;
+        topic_summary?: string;
+        timestamp: string;
+    };
+    content: string;
+    metadata: Record<string, any>;
+}
+export interface RecallMemoryOutput {
+    query: string;
+    context_used?: {
+        topic_segment_id: string;
+        topic_summary: string;
+    };
+    success: boolean;
+    results: MemoryResult[];
+    total_found: number;
+    retrieval_time_ms: number;
+    strategies_used: string[];
+    session_id: string;
+    error?: string;
+}
+export interface RecallMemoryConfig {
+    weights: {
+        semantic: number;
+        recency: number;
+        importance: number;
+    };
+    maxResults: number;
+    rerankEnabled: boolean;
+}
+/**
+ * Enhanced recall_memory MCP tool.
+ *
+ * Innovations:
+ * 1. Topic context fusion — blends query embedding with current topic embedding
+ * 2. Structured output — every result carries full context metadata
+ * 3. Agent-friendly — OmO agents pass caller_context for better retrieval
+ * 4. Enhanced filters — min_importance, tier, exclude_topic_segment_ids
+ *
+ * Backward compatible with simple { query: "..." } calls.
+ */
+export declare function recallMemory(input: RecallMemoryInput, pool: Pool, config?: Partial<RecallMemoryConfig>): Promise<RecallMemoryOutput>;
+//# sourceMappingURL=recall-memory.d.ts.map

package/dist/src/mcp/recall-memory.d.ts.map

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

package/dist/src/omo/adapter.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Oh My OpenAgent (OmO) 适配器
+ *
+ * 将 PG Memory 插件升格为 OmO 基础设施的核心适配层
+ * 处理多 Agent 环境下的记忆隔离、注入和反思
+ */
+import { Pool } from 'pg';
+import { OmOConfig, OmOMemoryInjection, OmOReflectionResult, OmOTaskCreatedEvent, OmOTaskCompletedEvent, OmOAgentSpawnedEvent, OmODCPCoordination } from './types';
+export interface OmOAdapterOptions {
+    config?: Partial<OmOConfig>;
+    pool: Pool;
+    omOCallbacks?: {
+        onWisdomCreated?: (wisdom: any) => Promise<void>;
+        onContextInjected?: (injection: OmOMemoryInjection) => Promise<void>;
+        getOmOContextBudget?: (agentId: string) => Promise<number>;
+    };
+}
+/**
+ * OmO 适配器主类
+ */
+export declare class OmOAdapter {
+    private config;
+    private pool;
+    private callbacks;
+    private agentContexts;
+    private dcpCoordination;
+    constructor(options: OmOAdapterOptions);
+    /**
+     * 初始化 OmO 适配器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 检测 OmO 环境
+     */
+    private detectOmOEnvironment;
+    /**
+     * 初始化 OmO 相关的数据库 Schema
+     */
+    private initializeOmOSchema;
+    /**
+     * 处理 omo.task.created
+     * 在任务创建时注入相关记忆
+     */
+    onTaskCreated(event: OmOTaskCreatedEvent): Promise<OmOMemoryInjection>;
+    /**
+     * 处理 omo.task.completed
+     * 触发反思任务
+     */
+    onTaskCompleted(event: OmOTaskCompletedEvent): Promise<OmOReflectionResult | null>;
+    /**
+     * 处理 omo.agent.spawned
+     * 初始化子 Agent 的上下文
+     */
+    onAgentSpawned(event: OmOAgentSpawnedEvent): Promise<void>;
+    /**
+     * 处理 omo.context.injection
+     * OmO 的上下文注入钩子（如果启用）
+     */
+    onContextInjection(agentId: string, taskContext: any): Promise<OmOMemoryInjection>;
+    /**
+     * 为任务注入记忆
+     */
+    private injectMemoryForTask;
+    /**
+     * 为 Agent 注入记忆
+     */
+    private injectMemoryForAgent;
+    /**
+     * 执行记忆注入
+     */
+    private executeMemoryInjection;
+    /**
+     * 按 Agent 范围过滤结果
+     */
+    private filterByAgentScope;
+    /**
+     * 计算与 OmO 协调的 Token 预算
+     */
+    private calculateCoordinatedBudget;
+    /**
+     * 执行反思任务
+     */
+    private performReflection;
+    /**
+     * 继承父 Agent 的上下文
+     */
+    private inheritParentContext;
+    /**
+     * 设置 DCP 协调模式
+     */
+    setDCPCoordination(coordination: Partial<OmODCPCoordination>): void;
+    /**
+     * 获取 DCP 协调状态
+     */
+    getDCPCoordination(): OmODCPCoordination;
+    /**
+     * 获取 Agent 统计信息
+     */
+    getAgentStats(agentId: string): Promise<{
+        observationCount: number;
+        cacheHitRate: number;
+        reflectionCount: number;
+        activeTasks: number;
+    }>;
+    /**
+     * 获取配置
+     */
+    getConfig(): OmOConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<OmOConfig>): void;
+}
+/**
+ * 将 MemoryResult 格式化为 Agent 可解析的结构化文本
+ *
+ * 用于 OmO Agent 的系统提示词注入，使 Agent 能够消费记忆结果
+ * 并融入决策链条。
+ *
+ * @param results - recall_memory 返回的结果列表
+ * @param maxPerType - 每种类型最多输出的条数 (默认: 5)
+ * @returns 格式化后的 Markdown 字符串
+ */
+export declare function formatMemoriesForAgent(results: Array<{
+    id: string;
+    type: string;
+    data: Record<string, any>;
+    relevance_score: number;
+    context: string;
+}>, maxPerType?: number): string;
+/**
+ * 为 Agent 系统提示词生成记忆使用指南
+ *
+ * 将此函数的输出注入到 OmO Agent 的系统提示词中，
+ * 以便 Agent 知道如何自主调用 recall_memory 和 hindsight_reflect。
+ *
+ * @returns Agent 系统提示词片段
+ */
+export declare function getMemoryAgentInstructions(): string;
+/**
+ * 创建 OmO 适配器实例
+ */
+export declare function createOmOAdapter(options: OmOAdapterOptions): OmOAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/omo/adapter.d.ts.map

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

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

@@ -0,0 +1,132 @@
+/**
+ * Oh My OpenAgent (OmO) 适配层类型定义
+ *
+ * 定义 OmO 特有的类型和接口，用于多 Agent 环境下的记忆管理
+ */
+export interface OmOAgent {
+    id: string;
+    name: string;
+    role: 'orchestrator' | 'worker' | 'specialist' | 'infrastructure';
+    parentAgentId?: string;
+    taskId?: string;
+    metadata?: Record<string, any>;
+}
+export interface OmOTaskContext {
+    taskId: string;
+    sessionId: string;
+    agentId: string;
+    parentTaskId?: string;
+    taskType: string;
+    priority: number;
+    deadline?: Date;
+}
+export type OmOHookType = 'omo.task.created' | 'omo.task.assigned' | 'omo.task.started' | 'omo.task.completed' | 'omo.task.failed' | 'omo.agent.spawned' | 'omo.agent.terminated' | 'omo.context.injection' | 'omo.wisdom.accumulation' | 'omo.session.init' | 'omo.session.cleanup';
+export interface OmOConfig {
+    enabled: boolean;
+    integrationMode: 'skill' | 'infrastructure' | 'hybrid';
+    infrastructureMode?: {
+        priority: 'high' | 'normal' | 'low';
+        reservedForAgents: string[];
+        disabledOmOHooks: OmOHookType[];
+        observationThreshold?: number;
+    };
+    skillMode?: {
+        skillName: string;
+        autoInject: boolean;
+        injectTiming: 'pre-task' | 'on-demand';
+    };
+    agentIsolation: {
+        enabled: boolean;
+        sharedTiers: ('permanent' | 'project')[];
+        isolatedTiers: ('session' | 'agent')[];
+    };
+    wisdomIntegration: {
+        enabled: boolean;
+        syncToOmO: boolean;
+        useOmOWisdom: boolean;
+        conflictResolution: 'omo-priority' | 'pg-memory-priority' | 'merge';
+    };
+    tokenBudgetCoordination: {
+        enabled: boolean;
+        respectOmOBudget: boolean;
+        budgetAllocation: 'omo-first' | 'equal' | 'memory-first';
+        maxOmOContextRatio: number;
+    };
+}
+export declare const DEFAULT_OMO_CONFIG: OmOConfig;
+export interface OmOMemoryQuery {
+    query: string;
+    sessionId: string;
+    agentId: string;
+    taskId?: string;
+    agentScope: 'self' | 'siblings' | 'parent' | 'children' | 'all';
+    tierFilter?: ('permanent' | 'project' | 'session' | 'agent')[];
+    includeOmOWisdom?: boolean;
+    strategies?: ('semantic' | 'bm25' | 'graph' | 'temporal')[];
+}
+export interface OmOMemoryInjection {
+    agentId: string;
+    taskId?: string;
+    injectedMemories: string[];
+    tokenCount: number;
+    sourceTiers: Record<string, number>;
+    omOBudgetReserved: number;
+    coordinationApplied: boolean;
+}
+export interface OmOReflectionResult {
+    reflectionId: string;
+    agentId: string;
+    sessionId: string;
+    patterns: Array<{
+        patternType: string;
+        description: string;
+        confidence: number;
+        sourceObservationIds: string[];
+    }>;
+    wisdomEntry?: {
+        id: string;
+        type: 'pattern' | 'insight' | 'lesson';
+        content: string;
+        metadata: {
+            source: 'pg-memory-hindsight';
+            agentId: string;
+            timestamp: string;
+            confidence: number;
+        };
+    };
+}
+export interface OmOTaskCreatedEvent {
+    taskId: string;
+    sessionId: string;
+    agentId: string;
+    taskType: string;
+    parentTaskId?: string;
+    contextSnapshot?: any;
+}
+export interface OmOTaskCompletedEvent {
+    taskId: string;
+    sessionId: string;
+    agentId: string;
+    result: any;
+    durationMs: number;
+    observationsCount: number;
+}
+export interface OmOAgentSpawnedEvent {
+    agentId: string;
+    parentAgentId?: string;
+    sessionId: string;
+    role: string;
+    initialContext?: any;
+}
+export interface OmODCPCoordination {
+    omODCPEnabled: boolean;
+    pgMemoryDCPEnabled: boolean;
+    coordinationMode: 'omo-only' | 'pg-memory-only' | 'coordinated';
+    activeDCPProvider: 'omo' | 'pg-memory' | 'none';
+    sharedCompactionState?: {
+        compactedMessageIds: string[];
+        preservedMessageIds: string[];
+        timestamp: Date;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/services/keyword.d.ts

@@ -0,0 +1,4 @@
+export declare function removeCodeBlocks(text: string): string;
+export declare function detectMemoryKeyword(text: string): boolean;
+export declare const MEMORY_NUDGE_MESSAGE = "[MEMORY TRIGGER DETECTED]\nThe user wants you to remember something important.\nConsider using the following tools to persist this knowledge:\n- recall_memory: to retrieve related context\n- The pg-memory plugin will automatically record this session's observations for future use.";
+//# sourceMappingURL=keyword.d.ts.map

package/dist/src/services/keyword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword.d.ts","sourceRoot":"","sources":["../../../src/services/keyword.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,eAAO,MAAM,oBAAoB,8RAI4D,CAAC"}

package/dist/src/services/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    debug(msg: string, data?: unknown): void;
+    info(msg: string, data?: unknown): void;
+    warn(msg: string, data?: unknown): void;
+    error(msg: string, data?: unknown): void;
+}
+export declare function createLogger(module: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/services/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/services/logger.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AAcD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnD"}

package/dist/src/services/privacy.d.ts

@@ -0,0 +1,4 @@
+export declare function containsPrivateTag(content: string): boolean;
+export declare function stripPrivateContent(content: string): string;
+export declare function isFullyPrivate(content: string): boolean;
+//# sourceMappingURL=privacy.d.ts.map

package/dist/src/services/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../../src/services/privacy.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIvD"}