opcode-pg-memory 2.2.0

package/dist/src/cache/semantic-cache.d.ts

@@ -0,0 +1,120 @@
+import { Pool } from 'pg';
+import { CacheResult } from '../types';
+export interface SemanticCacheConfig {
+    initialThreshold: number;
+    adjustmentStep: number;
+    minThreshold: number;
+    maxThreshold: number;
+    queryWindowSize: number;
+    enabled: boolean;
+}
+/**
+ * 语义缓存管理器
+ *
+ * 功能：
+ * 1. 使用 HNSW 索引实现亚 10ms 级检索
+ * 2. 动态阈值调整（初始 0.92，每 100 次查询根据命中率 ±0.02）
+ * 3. 与 DCP 协同，设置最高检索优先级
+ * 4. 缓存命中后直接返回，零 token 消耗
+ */
+export declare class SemanticCacheManager {
+    private pool;
+    private config;
+    private currentThreshold;
+    private queryCount;
+    private hitCount;
+    constructor(pool: Pool, config?: Partial<SemanticCacheConfig>);
+    /**
+     * 检查缓存
+     *
+     * 流程：
+     * 1. 生成查询哈希
+     * 2. 使用 HNSW 索引快速检索候选
+     * 3. 检查相似度是否达到阈值
+     * 4. 更新命中统计
+     */
+    checkCache(queryText: string): Promise<CacheResult & {
+        cached?: boolean;
+        cacheId?: string;
+        similarity?: number;
+    }>;
+    /**
+     * 存储缓存
+     */
+    storeCache(queryText: string, responseText: string, sessionId?: string): Promise<string | null>;
+    /**
+     * 记录缓存命中
+     */
+    private recordHit;
+    /**
+     * 记录缓存未命中
+     */
+    private recordMiss;
+    /**
+     * 动态调整阈值
+     *
+     * 策略：
+     * - 每 100 次查询检查一次
+     * - 命中率 < 30%：降低阈值（提高命中率）
+     * - 命中率 > 80%：提高阈值（提高精确度）
+     */
+    private maybeAdjustThreshold;
+    /**
+     * 生成查询哈希
+     */
+    private generateQueryHash;
+    /**
+     * 生成查询向量
+     *
+     * 注意：实际应调用 embedding API
+     */
+    private generateQueryEmbedding;
+    /**
+     * 标记缓存为已压缩（DCP 协同）
+     */
+    markAsPruned(cacheId: string): Promise<void>;
+    /**
+     * 批量标记缓存为已压缩
+     */
+    markMultipleAsPruned(cacheIds: string[]): Promise<void>;
+    /**
+     * 获取缓存统计
+     */
+    getStats(): Promise<{
+        totalEntries: number;
+        prunedEntries: number;
+        totalHits: number;
+        currentThreshold: number;
+        averageHitCount: number;
+    }>;
+    /**
+     * 清理过期缓存
+     */
+    cleanupExpiredCache(maxAgeDays?: number): Promise<number>;
+    /**
+     * 获取当前阈值
+     */
+    getCurrentThreshold(): number;
+    /**
+     * 手动设置阈值
+     */
+    setThreshold(threshold: number): Promise<void>;
+}
+/**
+ * 带缓存优先级的查询包装器
+ *
+ * 使用方式：
+ * 1. 首先检查语义缓存
+ * 2. 缓存命中：直接返回，零 token 消耗
+ * 3. 缓存未命中：执行实际查询，并存入缓存
+ */
+export declare function queryWithCachePriority<T>(queryText: string, actualQuery: () => Promise<T>, cacheManager: SemanticCacheManager, shouldCache?: (result: T) => boolean): Promise<{
+    result: T;
+    fromCache: boolean;
+    similarity?: number;
+}>;
+/**
+ * 创建缓存管理器实例
+ */
+export declare function createCacheManager(pool: Pool, config?: Partial<SemanticCacheConfig>): SemanticCacheManager;
+//# sourceMappingURL=semantic-cache.d.ts.map

package/dist/src/cache/semantic-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-cache.d.ts","sourceRoot":"","sources":["../../../src/cache/semantic-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE1B,OAAO,EAAiB,WAAW,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAWD;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAQjE;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG;QACzD,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IAsFF;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuDzB;;OAEG;YACW,SAAS;IAcvB;;OAEG;YACW,UAAU;IAKxB;;;;;;;OAOG;YACW,oBAAoB;IA+ClC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;YACW,sBAAsB;IAQpC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD;;OAEG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAmBF;;OAEG;IACG,mBAAmB,CAAC,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAanE;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAerD;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,YAAY,EAAE,oBAAoB,EAClC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,GACnC,OAAO,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CA0BD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,oBAAoB,CAEtB"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/config.d.ts

@@ -0,0 +1,39 @@
+export interface PgMemoryConfig {
+    pgHost?: string;
+    pgPort?: number;
+    pgDatabase?: string;
+    pgUser?: string;
+    pgPassword?: string;
+    embeddingProvider?: "ollama" | "deepseek" | "openai";
+    embeddingModel?: string;
+    embeddingDimensions?: number;
+    embeddingBatchSize?: number;
+    similarityThreshold?: number;
+    maxMemories?: number;
+    logLevel?: "debug" | "info" | "warn" | "error";
+    compactionThreshold?: number;
+}
+export declare const CONFIG: {
+    pgHost: string;
+    pgPort: number;
+    pgDatabase: string;
+    pgUser: string;
+    pgPassword: string;
+    embeddingProvider: "ollama" | "deepseek" | "openai";
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingBatchSize: number;
+    similarityThreshold: number;
+    maxMemories: number;
+    logLevel: "debug" | "info" | "warn" | "error";
+    compactionThreshold: number;
+};
+export declare function isConfigured(): boolean;
+export declare function getDatabaseConfig(): {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA8CD,eAAO,MAAM,MAAM;;;;;;uBAMoG,QAAQ,GAAG,UAAU,GAAG,QAAQ;;;;;;cAM1D,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;CAE/H,CAAC;AAEF,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,iBAAiB;;;;;;EAQhC"}

package/dist/src/db/init-db.d.ts

@@ -0,0 +1,45 @@
+import { Pool } from 'pg';
+export interface DatabaseConfig {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean | object;
+    maxConnections?: number;
+}
+export declare const DEFAULT_DB_CONFIG: DatabaseConfig;
+export declare class DatabaseInitializer {
+    private pool;
+    private config;
+    constructor(config?: Partial<DatabaseConfig>);
+    initialize(): Promise<Pool>;
+    private testConnection;
+    private setupDatabase;
+    private createExtensions;
+    private createEnums;
+    private createTables;
+    private createIndexes;
+    /**
+     * 迁移旧列名 session_id → session_map_id
+     *
+     * 兼容从 v1.x 升级的场景：旧 schema 中 entities/observations 等子表
+     * 使用 session_id 列名，但新 schema 使用 session_map_id。
+     * 重命名是 PostgreSQL 元数据操作，不重写数据行，FK 关联自动继承新列名。
+     */
+    private migrateLegacyColumnNames;
+    /**
+     * 将旧 sessions 表的数据迁移到新的 session_map 表。
+     * 旧 sessions 表保留不删除（_legacy），仅复制元数据映射。
+     * 注意：子表（entities/observations 等）的 session_map_id 不会自动填充，
+     * 需要单独的迁移脚本处理 FK 重映射。
+     */
+    private migrateSessionsData;
+    private initializeOmOSchema;
+    close(): Promise<void>;
+    getPool(): Pool;
+}
+export declare function getDatabaseInitializer(config?: Partial<DatabaseConfig>): DatabaseInitializer;
+export declare function initializeDatabase(config?: Partial<DatabaseConfig>): Promise<Pool>;
+export declare function closeDatabase(): Promise<void>;
+//# sourceMappingURL=init-db.d.ts.map

package/dist/src/db/init-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-db.d.ts","sourceRoot":"","sources":["../../../src/db/init-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAGtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,EAAE,cAQ/B,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAI1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA4BnB,cAAc;YAYd,aAAa;YAqCb,gBAAgB;YAQhB,WAAW;YAgBX,YAAY;YAgKZ,aAAa;IAkI3B;;;;;;OAMG;YACW,wBAAwB;IA8BtC;;;;;OAKG;YACW,mBAAmB;YA8BnB,mBAAmB;IAmF3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,IAAI,IAAI;CAMhB;AAKD,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,mBAAmB,CAK5F;AAED,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAKnD"}

package/dist/src/hooks/message-part-updated.d.ts

@@ -0,0 +1,24 @@
+import { Pool } from 'pg';
+import { MessagePartUpdatedInput, MessagePartUpdatedOutput } from '../types';
+export interface MessagePartUpdatedHandlerConfig {
+    maxContentLength: number;
+    accumulationTimeoutMs: number;
+}
+/**
+ * 处理 message.part.updated 事件
+ *
+ * 功能：
+ * 1. 监听工具输出的增量更新
+ * 2. 触发经验增量记录
+ * 3. 累积部分内容，在 isComplete = true 时统一处理
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleMessagePartUpdated(input: MessagePartUpdatedInput, output: MessagePartUpdatedOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<MessagePartUpdatedHandlerConfig>): Promise<void>;
+/**
+ * 清理过期的累积器（防止内存泄漏）
+ * 应定期调用
+ */
+export declare function cleanupExpiredAccumulators(maxAgeMs?: number): void;
+//# sourceMappingURL=message-part-updated.d.ts.map

package/dist/src/hooks/message-part-updated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-part-updated.d.ts","sourceRoot":"","sources":["../../../src/hooks/message-part-updated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,WAAW,+BAA+B;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAgBD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,MAAM,EAAE,wBAAwB,EAAK,iBAAiB;AACtD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,+BAA+B,CAAM,GACpD,OAAO,CAAC,IAAI,CAAC,CAkDf;AA0JD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,MAAe,GAAG,IAAI,CAc1E"}

package/dist/src/hooks/message-updated.d.ts

@@ -0,0 +1,24 @@
+import { Pool } from 'pg';
+import { MessageUpdatedInput, MessageUpdatedOutput } from '../types';
+export interface MessageUpdatedHandlerConfig {
+    minConfidence: number;
+    minEntityNameLength: number;
+    maxEntitiesPerMessage: number;
+    maxRelationsPerEntity: number;
+}
+/**
+ * 处理 message.updated 事件
+ *
+ * 功能：
+ * 1. 存储原始消息到 messages 表
+ * 2. 异步调用 LLM 提取命名实体
+ * 3. 识别实体间关系
+ * 4. 写入 entities 表（置信度 < 0.5 的不写入）
+ * 5. 写入 relations 表（置信度 < 0.5 的不写入）
+ * 6. 更新实体 weight 和 last_seen_at
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleMessageUpdated(input: MessageUpdatedInput, output: MessageUpdatedOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<MessageUpdatedHandlerConfig>): Promise<void>;
+//# sourceMappingURL=message-updated.d.ts.map

package/dist/src/hooks/message-updated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-updated.d.ts","sourceRoot":"","sources":["../../../src/hooks/message-updated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AASD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,EAAK,iBAAiB;AAClD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/src/hooks/session-compacting.d.ts

@@ -0,0 +1,50 @@
+import { Pool } from 'pg';
+import { SessionCompactingInput, SessionCompactingOutput } from '../types';
+export interface SessionCompactingHandlerConfig {
+    preserveHighImportanceObservations: boolean;
+    minImportanceToPreserve: number;
+    markPrunedInCache: boolean;
+}
+/**
+ * 处理 experimental.session.compacting / session.compacted 事件
+ *
+ * 功能：
+ * 1. 标记将被压缩的低价值消息
+ * 2. 避免对已压缩消息重复产生缓存
+ * 3. 与 DCP 协同，semantic_cache 检索优先级设为最高
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleSessionCompacting(input: SessionCompactingInput, output: SessionCompactingOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<SessionCompactingHandlerConfig>): Promise<void>;
+/**
+ * 获取缓存优先级配置
+ *
+ * 说明：
+ * - semantic_cache 检索优先级设为最高（在 DCP 处理之前执行缓存查找）
+ * - 缓存命中后直接返回，无需进入 DCP 通道（零 token 消耗）
+ */
+export declare function getCachePriorityConfig(): {
+    priority: number;
+    bypassDCPOnHit: boolean;
+};
+/**
+ * 处理 session.compacted 事件（压缩完成后）
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleSessionCompacted(input: SessionCompactingInput, output: SessionCompactingOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<SessionCompactingHandlerConfig>): Promise<void>;
+/**
+ * 检查消息是否已被压缩
+ */
+export declare function isMessageCompacted(sessionId: string, messageId: string, pool: Pool): Promise<boolean>;
+/**
+ * 获取会话的压缩统计
+ */
+export declare function getCompactionStats(sessionId: string, pool: Pool): Promise<{
+    totalObservations: number;
+    prunedCacheEntries: number;
+    highImportanceObservations: number;
+}>;
+//# sourceMappingURL=session-compacting.d.ts.map

package/dist/src/hooks/session-compacting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-compacting.d.ts","sourceRoot":"","sources":["../../../src/hooks/session-compacting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAE3E,MAAM,WAAW,8BAA8B;IAC7C,kCAAkC,EAAE,OAAO,CAAC;IAC5C,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,uBAAuB,EAAK,iBAAiB;AACrD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,8BAA8B,CAAM,GACnD,OAAO,CAAC,IAAI,CAAC,CA0Df;AAgED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB,CAOA;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,uBAAuB,EAAK,iBAAiB;AACrD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,8BAA8B,CAAM,GACnD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IACT,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;CACpC,CAAC,CA2BD"}

package/dist/src/hooks/session-completed.d.ts

@@ -0,0 +1,36 @@
+import { Pool } from 'pg';
+import { SessionCompletedInput, SessionCompletedOutput } from '../types';
+export interface SessionCompletedHandlerConfig {
+    reflectionThreshold: number;
+    minObservationThreshold: number;
+    maxObservationThreshold: number;
+    enableReflection: boolean;
+    offPeakHours: number[];
+}
+/**
+ * 处理 session.completed 事件
+ *
+ * 功能：
+ * 1. 异步触发 hindsight_reflect 反思任务
+ * 2. 检查 observations 数量是否达到阈值 (30-50条)
+ * 3. 更新 sessions.reflection_last_at
+ * 4. 使用 7B 蒸馏模型在低峰期执行
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleSessionCompleted(input: SessionCompletedInput, output: SessionCompletedOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<SessionCompletedHandlerConfig>): Promise<void>;
+/**
+ * 获取反思队列（供定时任务调用）
+ */
+export declare function getPendingReflections(pool: Pool): Promise<Array<{
+    sessionId: string;
+    externalSessionId: string;
+    observationCount: number;
+    queuedAt: Date;
+}>>;
+/**
+ * 处理反思错误重试
+ */
+export declare function retryFailedReflections(pool: Pool, maxRetries?: number): Promise<void>;
+//# sourceMappingURL=session-completed.d.ts.map

package/dist/src/hooks/session-completed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-completed.d.ts","sourceRoot":"","sources":["../../../src/hooks/session-completed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEzE,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAUD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,sBAAsB,EAAK,iBAAiB;AACpD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,6BAA6B,CAAM,GAClD,OAAO,CAAC,IAAI,CAAC,CAuFf;AA6RD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC,CAAC,CAmBF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/src/hooks/session-created.d.ts

@@ -0,0 +1,23 @@
+import { Pool } from 'pg';
+import { SessionCreatedInput, SessionCreatedOutput } from '../types';
+export interface SessionCreatedHandlerConfig {
+    contextLimitRatio: number;
+    minTokens: number;
+    maxTokens: number;
+    minConfidence: number;
+    minWeight: number;
+}
+/**
+ * 处理 session.created 事件
+ *
+ * 功能：
+ * 1. 创建或更新 sessions 表记录
+ * 2. 基于 Token 预算检索 entities 和 reflections
+ * 3. 优先注入 permanent 级别事实，其次 project，最后 session
+ *
+ * 签名规范：(input, output) => Promise<void>
+ * output 为可变对象，通过突变 output 影响行为
+ */
+export declare function handleSessionCreated(input: SessionCreatedInput, output: SessionCreatedOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<SessionCreatedHandlerConfig>): Promise<void>;
+//# sourceMappingURL=session-created.d.ts.map

package/dist/src/hooks/session-created.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-created.d.ts","sourceRoot":"","sources":["../../../src/hooks/session-created.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAIrB,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,EAAK,iBAAiB;AAClD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/src/hooks/tool-execute.d.ts

@@ -0,0 +1,32 @@
+import { Pool } from 'pg';
+import { ToolExecuteBeforeInput, ToolExecuteBeforeOutput, ToolExecuteAfterInput, ToolExecuteAfterOutput } from '../types';
+export interface ToolExecuteHandlerConfig {
+    maxInputSummaryLength: number;
+    maxOutputSummaryLength: number;
+    defaultImportance: number;
+}
+/**
+ * 处理 tool.execute.before 事件
+ *
+ * 功能：
+ * 1. 记录工具调用参数摘要到 observations 表
+ * 2. 零 token 开销，仅做记录
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleToolExecuteBefore(input: ToolExecuteBeforeInput, output: ToolExecuteBeforeOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<ToolExecuteHandlerConfig>): Promise<void>;
+/**
+ * 处理 tool.execute.after 事件
+ *
+ * 功能：
+ * 1. 生成工具输出摘要
+ * 2. 异步向量化摘要内容
+ * 3. 更新 observations 表
+ * 4. 记录 token 使用
+ *
+ * 签名规范：(input, output) => Promise<void>
+ */
+export declare function handleToolExecuteAfter(input: ToolExecuteAfterInput, output: ToolExecuteAfterOutput, // ✅ 添加 output 参数
+pool: Pool, config?: Partial<ToolExecuteHandlerConfig>): Promise<void>;
+//# sourceMappingURL=tool-execute.d.ts.map

package/dist/src/hooks/tool-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-execute.d.ts","sourceRoot":"","sources":["../../../src/hooks/tool-execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,uBAAuB,EAAK,iBAAiB;AACrD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAC7C,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,sBAAsB,EAAK,iBAAiB;AACpD,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAC7C,OAAO,CAAC,IAAI,CAAC,CAyGf"}

package/dist/src/index.d.ts

@@ -0,0 +1,64 @@
+interface PluginContext {
+    /** OpenCode SDK client */
+    client: any;
+    /** Project metadata */
+    project: any;
+    /** Working directory */
+    directory: string;
+}
+/** Official Plugin export signature */
+type Plugin = (ctx: PluginContext) => Promise<PluginHooks>;
+interface PluginHooks {
+    /** Unified event hook - receives ALL bus events */
+    event?: (input: {
+        event: {
+            type: string;
+            properties: Record<string, any>;
+        };
+    }) => Promise<void>;
+    /** Tool execute before - args mutation */
+    'tool.execute.before'?: (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: any;
+    }) => Promise<void>;
+    /** Tool execute after - title/output mutation */
+    'tool.execute.after'?: (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+        args: any;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: any;
+    }) => Promise<void>;
+    /** Session compacting hook */
+    'experimental.session.compacting'?: (input: {
+        sessionID: string;
+    }, output: {
+        context: string[];
+        prompt?: string;
+    }) => Promise<void>;
+    /** Custom MCP tools */
+    tool?: Record<string, PluginTool>;
+    [key: string]: any;
+}
+interface PluginTool {
+    description: string;
+    args: Record<string, any>;
+    execute: (args: any, context: {
+        client: any;
+        sessionID?: string;
+    }) => Promise<any>;
+}
+export declare const OpenCodePGMemory: Plugin;
+export * from './types';
+export * from './db/init-db';
+export * from './utils/token-budget';
+export * from './cache/semantic-cache';
+export { recallMemory } from './mcp/recall-memory';
+export { hindsightReflect } from './mcp/hindsight-reflect';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAoBA,UAAU,aAAa;IACrB,0BAA0B;IAC1B,MAAM,EAAE,GAAG,CAAC;IACZ,uBAAuB;IACvB,OAAO,EAAE,GAAG,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE3D,UAAU,WAAW;IACnB,mDAAmD;IACnD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7H,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1K,8BAA8B;IAC9B,iCAAiC,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpI,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACpF;AAwJD,eAAO,MAAM,gBAAgB,EAAE,MA2f9B,CAAC;AA8JF,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * hindsight_reflect MCP 工具 - OmO 适配版本
+ *
+ * 针对 Oh My OpenAgent 多 Agent 环境优化的反思工具
+ * 与 OmO Wisdom Accumulation 机制集成
+ */
+import { Pool } from 'pg';
+import { HindsightReflectInput, HindsightReflectOutput } from './hindsight-reflect';
+export interface HindsightReflectOmOInput extends HindsightReflectInput {
+    agent_id: string;
+    task_id?: string;
+    parent_session_id?: string;
+    sync_to_omo_wisdom?: boolean;
+    omo_wisdom_tags?: string[];
+    reflection_scope?: 'agent-only' | 'task-only' | 'session-wide' | 'hierarchical';
+    respect_omo_timeout?: boolean;
+    omo_timeout_deadline?: string;
+}
+export interface HindsightReflectOmOOutput extends HindsightReflectOutput {
+    agent_id: string;
+    task_id?: string;
+    success?: boolean;
+    error?: string;
+    omo_wisdom_synced: boolean;
+    omo_wisdom_entries?: Array<{
+        id: string;
+        type: string;
+        content: string;
+    }>;
+    cross_agent_stats?: {
+        total_observations: number;
+        own_observations: number;
+        inherited_observations: number;
+        child_agent_observations: number;
+    };
+    coordination_status: {
+        completed_before_timeout: boolean;
+        timeout_was_respected: boolean;
+        omo_acknowledged: boolean;
+    };
+}
+/**
+ * OmO 版本的 hindsight_reflect 工具
+ *
+ * 主要差异：
+ * 1. 支持按 Agent 范围反思
+ * 2. 与 OmO Wisdom Accumulation 同步
+ * 3. 尊重 OmO 后台超时控制
+ * 4. 支持层级反思（父子 Agent）
+ */
+export declare function hindsightReflectOmO(input: HindsightReflectOmOInput, pool: Pool): Promise<HindsightReflectOmOOutput>;
+/**
+ * 获取排队的反思任务
+ */
+export declare function getQueuedReflections(pool: Pool): Promise<Array<{
+    session_id: string;
+    agent_id: string;
+    coordination_data: any;
+}>>;
+/**
+ * 处理排队的反思任务
+ */
+export declare function processQueuedReflections(pool: Pool): Promise<void>;
+//# sourceMappingURL=hindsight-reflect-omo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hindsight-reflect-omo.d.ts","sourceRoot":"","sources":["../../../src/mcp/hindsight-reflect-omo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAoB,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEtG,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IAErE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,gBAAgB,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;IAGhF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IAEvE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,KAAK,CAAC;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAGH,iBAAiB,CAAC,EAAE;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;IAGF,mBAAmB,EAAE;QACnB,wBAAwB,EAAE,OAAO,CAAC;QAClC,qBAAqB,EAAE,OAAO,CAAC;QAC/B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,EAC/B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,yBAAyB,CAAC,CA6FpC;AAuND;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,GAAG,CAAC;CACxB,CAAC,CAAC,CASF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBxE"}