@lingxiao-office/sdk 1.0.0

package/dist/memory/MemoryService.d.ts

@@ -0,0 +1,82 @@
+/**
+ * MemoryService — Unified entry point for FTS-backed memory search.
+ *
+ * Manages lifecycle of MemoryFTS + MemoryReconciler, provides
+ * high-level search and reconciliation APIs.
+ */
+import { type ReconcileResult } from './MemoryReconciler.js';
+import type { MemorySearchResult, MemoryFTSSearchOptions, MemoryFTSEntry } from './types.js';
+export interface MemoryServiceOptions {
+    /** Workspace root (project directory). */
+    workspace?: string;
+    /**
+     * Directly override the memory root that gets indexed. Takes precedence over
+     * `workspace`. Use this for roots that are not `<workspace>/.lingxiao/memory`
+     * (e.g. the user-level `~/.lingxiao/memory` directory, which IS the root).
+     */
+    memoryRoot?: string;
+    /** Override for user-level memory directory. */
+    userMemoryDir?: string;
+    /** Override for the FTS database path. */
+    dbPath?: string;
+    /**
+     * Whether search() reconciles the filesystem→index first. Default true,
+     * matching mimo's reconcile-on-search. Reconciliation is fingerprint
+     * (size+mtime) incremental, so unchanged files are skipped cheaply — there is
+     * no time-based throttle, which would otherwise serve stale results inside its
+     * window. Set false only when an external caller drives reconciliation.
+     */
+    reconcileOnSearch?: boolean;
+    /**
+     * Relevance floor ratio for BM25 search: hits scoring below
+     * `topScore * searchScoreFloor` are trimmed (the #1 hit is always kept).
+     * Defaults to 0.15, matching mimo. Wired from `config.memory.search_score_floor`.
+     */
+    searchScoreFloor?: number;
+}
+export declare class MemoryService {
+    private fts;
+    private reconciler;
+    private memoryRoot;
+    private dbPath;
+    private readonly reconcileOnSearch;
+    private readonly searchScoreFloor;
+    constructor(options?: MemoryServiceOptions);
+    /** Ensure FTS engine is initialized. */
+    private ensureFTS;
+    /** Ensure reconciler is initialized. */
+    private ensureReconciler;
+    /**
+     * Search memory with FTS5/BM25.
+     * Automatically reconciles if stale (cooldown-based).
+     */
+    search(query: string, options?: MemoryFTSSearchOptions): MemorySearchResult[];
+    /**
+     * Force a full reconciliation of the filesystem with the FTS index.
+     */
+    reconcile(): ReconcileResult;
+    /**
+     * Reconcile only a specific subdirectory.
+     */
+    reconcilePath(dirPath: string): ReconcileResult;
+    /**
+     * Get entries by scope (for /dream to find session checkpoints).
+     */
+    getByScope(scope: 'global' | 'project' | 'session', scopeId?: string): MemoryFTSEntry[];
+    /**
+     * Get checkpoint entries indexed after a given timestamp.
+     */
+    getRecentCheckpoints(afterTimestamp: number): MemoryFTSEntry[];
+    /**
+     * Check FTS5 engine availability.
+     */
+    isFTS5Available(): boolean;
+    /**
+     * Close the FTS database.
+     */
+    close(): void;
+    /** Memory root path getter. */
+    getMemoryRoot(): string;
+    private maybeReconcile;
+}
+//# sourceMappingURL=MemoryService.d.ts.map

package/dist/memory/MemoryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryService.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7F,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,GAAE,oBAAyB;IAY9C,wCAAwC;IACxC,OAAO,CAAC,SAAS;IAQjB,wCAAwC;IACxC,OAAO,CAAC,gBAAgB;IAKxB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,EAAE;IAMjF;;OAEG;IACH,SAAS,IAAI,eAAe;IAO5B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAK/C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAMvF;;OAEG;IACH,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,EAAE;IAM9D;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,+BAA+B;IAC/B,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/memory/MemoryService.js

@@ -0,0 +1,114 @@
+/**
+ * MemoryService — Unified entry point for FTS-backed memory search.
+ *
+ * Manages lifecycle of MemoryFTS + MemoryReconciler, provides
+ * high-level search and reconciliation APIs.
+ */
+import { join } from 'node:path';
+import { MemoryFTS } from './MemoryFTS.js';
+import { MemoryReconciler } from './MemoryReconciler.js';
+import { coreLogger } from '../core/Log.js';
+export class MemoryService {
+    fts = null;
+    reconciler = null;
+    memoryRoot;
+    dbPath;
+    reconcileOnSearch;
+    searchScoreFloor;
+    constructor(options = {}) {
+        const workspace = options.workspace || process.cwd();
+        this.memoryRoot = options.memoryRoot || join(workspace, '.lingxiao', 'memory');
+        // DB sits alongside the root it indexes so distinct roots get distinct indexes.
+        this.dbPath = options.dbPath
+            || (options.memoryRoot
+                ? join(options.memoryRoot, 'memory_fts.sqlite')
+                : join(workspace, '.lingxiao', 'memory_fts.sqlite'));
+        this.reconcileOnSearch = options.reconcileOnSearch ?? true;
+        this.searchScoreFloor = options.searchScoreFloor ?? 0.15;
+    }
+    /** Ensure FTS engine is initialized. */
+    ensureFTS() {
+        if (!this.fts) {
+            this.fts = new MemoryFTS(this.dbPath, this.searchScoreFloor);
+            this.reconciler = new MemoryReconciler(this.memoryRoot, this.fts);
+        }
+        return this.fts;
+    }
+    /** Ensure reconciler is initialized. */
+    ensureReconciler() {
+        this.ensureFTS();
+        return this.reconciler;
+    }
+    /**
+     * Search memory with FTS5/BM25.
+     * Automatically reconciles if stale (cooldown-based).
+     */
+    search(query, options = {}) {
+        this.ensureFTS();
+        this.maybeReconcile();
+        return this.fts.search(query, options);
+    }
+    /**
+     * Force a full reconciliation of the filesystem with the FTS index.
+     */
+    reconcile() {
+        const reconciler = this.ensureReconciler();
+        const result = reconciler.reconcile();
+        coreLogger.info(`[MemoryService] Reconciled: scanned=${result.scanned} upserted=${result.upserted} pruned=${result.pruned}`);
+        return result;
+    }
+    /**
+     * Reconcile only a specific subdirectory.
+     */
+    reconcilePath(dirPath) {
+        const reconciler = this.ensureReconciler();
+        return reconciler.reconcilePath(dirPath);
+    }
+    /**
+     * Get entries by scope (for /dream to find session checkpoints).
+     */
+    getByScope(scope, scopeId) {
+        this.ensureFTS();
+        this.maybeReconcile();
+        return this.fts.getByScope(scope, scopeId);
+    }
+    /**
+     * Get checkpoint entries indexed after a given timestamp.
+     */
+    getRecentCheckpoints(afterTimestamp) {
+        this.ensureFTS();
+        this.maybeReconcile();
+        return this.fts.getByTypeAfter('checkpoint', afterTimestamp);
+    }
+    /**
+     * Check FTS5 engine availability.
+     */
+    isFTS5Available() {
+        return this.ensureFTS().isFTS5Available();
+    }
+    /**
+     * Close the FTS database.
+     */
+    close() {
+        if (this.fts) {
+            this.fts.close();
+            this.fts = null;
+            this.reconciler = null;
+        }
+    }
+    /** Memory root path getter. */
+    getMemoryRoot() {
+        return this.memoryRoot;
+    }
+    maybeReconcile() {
+        if (!this.reconcileOnSearch)
+            return;
+        try {
+            this.ensureReconciler().reconcile();
+        }
+        catch (err) {
+            coreLogger.warn(`[MemoryService] Auto-reconcile failed: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+}
+//# sourceMappingURL=MemoryService.js.map

package/dist/memory/MemoryService.js.map

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

package/dist/memory/TrajectoryReader.d.ts

@@ -0,0 +1,39 @@
+/**
+ * TrajectoryReader — read-only access to the raw conversation trajectory.
+ *
+ * The trajectory tables (leader_conversation + agent_conversation) are the
+ * source of truth for what actually happened in a project: verbatim user words,
+ * assistant output, tool-call inputs, and reasoning. Checkpoints are a lossy
+ * second compression layered on top. /dream and /distill both consolidate from
+ * this upstream signal — mimo's design treats raw trajectory as authoritative
+ * and memory files as a cache, and this module gives the deterministic command
+ * classes that same authoritative input.
+ *
+ * Everything here is read-only SQL with no heuristic scoring: a time-bounded,
+ * newest-first window over both tables, flattened to plain text.
+ */
+import type { TrajectoryTurn } from './types.js';
+/**
+ * Resolve the session database path.
+ * Priority: explicit > env (LINGXIAO_DB_PATH) > default (~/.lingxiao/data.db).
+ */
+export declare function resolveSessionDbPath(explicit?: string): string;
+/**
+ * Pull the raw conversation trajectory within a lookback window.
+ *
+ * timestamp columns store `Date.now()/1000` (unix seconds); `afterTimestampMs`
+ * is supplied in epoch milliseconds (the same units callers compute for the
+ * checkpoint cutoff) and converted here.
+ *
+ * @param dbPath resolved session DB path.
+ * @param afterTimestampMs lower bound in epoch milliseconds.
+ * @param maxTurns hard cap, newest-first, to bound LLM input.
+ */
+export declare function readRecentTrajectory(dbPath: string, afterTimestampMs: number, maxTurns?: number): TrajectoryTurn[];
+/** Flatten a stored content column (plain string or JSON content blocks) to text. */
+export declare function flattenContent(raw: unknown): string;
+/** Render stored tool_calls JSON into compact "name(input…)" lines. */
+export declare function summarizeToolCalls(raw: unknown): string[];
+/** Render trajectory turns into a compact, token-bounded transcript for an LLM. */
+export declare function renderTrajectory(turns: TrajectoryTurn[], maxTextPerTurn?: number): string;
+//# sourceMappingURL=TrajectoryReader.d.ts.map

package/dist/memory/TrajectoryReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryReader.d.ts","sourceRoot":"","sources":["../../src/memory/TrajectoryReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,cAAc,EAAE,CAuC/G;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAyBnD;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAiBzD;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,cAAc,SAAM,GAAG,MAAM,CAatF"}

package/dist/memory/TrajectoryReader.js

@@ -0,0 +1,150 @@
+/**
+ * TrajectoryReader — read-only access to the raw conversation trajectory.
+ *
+ * The trajectory tables (leader_conversation + agent_conversation) are the
+ * source of truth for what actually happened in a project: verbatim user words,
+ * assistant output, tool-call inputs, and reasoning. Checkpoints are a lossy
+ * second compression layered on top. /dream and /distill both consolidate from
+ * this upstream signal — mimo's design treats raw trajectory as authoritative
+ * and memory files as a cache, and this module gives the deterministic command
+ * classes that same authoritative input.
+ *
+ * Everything here is read-only SQL with no heuristic scoring: a time-bounded,
+ * newest-first window over both tables, flattened to plain text.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { coreLogger } from '../core/Log.js';
+/**
+ * Resolve the session database path.
+ * Priority: explicit > env (LINGXIAO_DB_PATH) > default (~/.lingxiao/data.db).
+ */
+export function resolveSessionDbPath(explicit) {
+    if (explicit)
+        return explicit;
+    if (process.env.LINGXIAO_DB_PATH)
+        return process.env.LINGXIAO_DB_PATH;
+    return join(homedir(), '.lingxiao', 'data.db');
+}
+/**
+ * Pull the raw conversation trajectory within a lookback window.
+ *
+ * timestamp columns store `Date.now()/1000` (unix seconds); `afterTimestampMs`
+ * is supplied in epoch milliseconds (the same units callers compute for the
+ * checkpoint cutoff) and converted here.
+ *
+ * @param dbPath resolved session DB path.
+ * @param afterTimestampMs lower bound in epoch milliseconds.
+ * @param maxTurns hard cap, newest-first, to bound LLM input.
+ */
+export function readRecentTrajectory(dbPath, afterTimestampMs, maxTurns = 400) {
+    const afterSec = afterTimestampMs / 1000;
+    if (!existsSync(dbPath)) {
+        coreLogger.warn(`[TrajectoryReader] Session database not found at ${dbPath}`);
+        return [];
+    }
+    const db = new DatabaseSync(dbPath);
+    try {
+        db.exec('PRAGMA query_only = ON');
+        // UNION the two trajectory tables into one time-ordered stream. Both share
+        // role/content/tool_calls/timestamp; leader has no agent column.
+        const rows = db.prepare(`SELECT * FROM (
+         SELECT session_id, 'leader' AS agent, role, content, tool_calls, timestamp
+           FROM leader_conversation WHERE timestamp > ?
+         UNION ALL
+         SELECT session_id, COALESCE(NULLIF(agent_name, ''), agent_id, 'worker') AS agent,
+                role, content, tool_calls, timestamp
+           FROM agent_conversation WHERE timestamp > ?
+       )
+       ORDER BY timestamp DESC
+       LIMIT ?`).all(afterSec, afterSec, maxTurns);
+        return rows.map((r) => ({
+            sessionId: String(r.session_id ?? ''),
+            agent: String(r.agent ?? 'leader'),
+            role: String(r.role ?? ''),
+            text: flattenContent(r.content),
+            toolCalls: summarizeToolCalls(r.tool_calls),
+            timestamp: Number(r.timestamp ?? 0),
+        }));
+    }
+    catch (err) {
+        coreLogger.warn(`[TrajectoryReader] Trajectory read failed: ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+    finally {
+        db.close();
+    }
+}
+/** Flatten a stored content column (plain string or JSON content blocks) to text. */
+export function flattenContent(raw) {
+    if (raw == null)
+        return '';
+    const str = String(raw);
+    const trimmed = str.trim();
+    if (!trimmed.startsWith('[') && !trimmed.startsWith('{'))
+        return str;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed === 'string')
+            return parsed;
+        if (Array.isArray(parsed)) {
+            return parsed
+                .map((block) => {
+                if (typeof block === 'string')
+                    return block;
+                if (block && typeof block === 'object' && 'text' in block)
+                    return String(block.text ?? '');
+                return '';
+            })
+                .filter(Boolean)
+                .join('\n');
+        }
+        if (parsed && typeof parsed === 'object' && 'text' in parsed) {
+            return String(parsed.text ?? '');
+        }
+        return str;
+    }
+    catch {
+        return str;
+    }
+}
+/** Render stored tool_calls JSON into compact "name(input…)" lines. */
+export function summarizeToolCalls(raw) {
+    if (raw == null)
+        return [];
+    try {
+        const calls = JSON.parse(String(raw));
+        if (!Array.isArray(calls))
+            return [];
+        return calls.map((c) => {
+            const fn = (c && typeof c === 'object' && 'function' in c)
+                ? c.function
+                : undefined;
+            const name = fn?.name ?? (c && typeof c === 'object' && 'name' in c ? String(c.name) : 'tool');
+            const args = fn?.arguments ?? '';
+            const argPreview = typeof args === 'string' ? args.slice(0, 160) : '';
+            return argPreview ? `${name}(${argPreview})` : String(name);
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** Render trajectory turns into a compact, token-bounded transcript for an LLM. */
+export function renderTrajectory(turns, maxTextPerTurn = 600) {
+    return turns
+        .map((t) => {
+        const who = t.agent === 'leader' ? t.role : `${t.role}@${t.agent}`;
+        const text = t.text.length > maxTextPerTurn ? t.text.slice(0, maxTextPerTurn) + '…' : t.text;
+        const lines = [`[${who}] ${text}`.trim()];
+        for (const call of t.toolCalls) {
+            lines.push(`  → ${call}`);
+        }
+        return lines.join('\n');
+    })
+        .filter((block) => block.trim().length > 0)
+        .join('\n');
+}
+//# sourceMappingURL=TrajectoryReader.js.map

package/dist/memory/TrajectoryReader.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Memory FTS type definitions.
+ *
+ * Scopes represent the isolation level of memory entries:
+ * - global: cross-project user preferences
+ * - project: project-specific knowledge
+ * - session: per-session ephemeral data (checkpoints, notes, progress)
+ */
+export type MemoryFTSScope = 'global' | 'project' | 'session';
+export type MemoryFTSType = 'memory' | 'checkpoint' | 'progress' | 'notes' | 'free';
+export interface MemoryFTSEntry {
+    id: string;
+    path: string;
+    scope: MemoryFTSScope;
+    scope_id: string;
+    type: MemoryFTSType;
+    body: string;
+    fingerprint: string;
+    last_indexed_at: number;
+    /** P1: Optional embedding vector for hybrid search */
+    embedding?: number[];
+}
+export interface MemorySearchResult {
+    path: string;
+    snippet: string;
+    score: number;
+    scope: MemoryFTSScope;
+    scope_id: string;
+    type: MemoryFTSType;
+    /** P1: FTS (BM25) component score, for hybrid search debugging */
+    ftsScore?: number;
+    /** P1: Vector cosine similarity component score, for hybrid search debugging */
+    vectorScore?: number;
+}
+export interface MemoryFTSSearchOptions {
+    scopes?: MemoryFTSScope[];
+    scopeIds?: string[];
+    types?: MemoryFTSType[];
+    maxResults?: number;
+    scoreFloor?: number;
+}
+/**
+ * A single raw conversation turn pulled straight from the trajectory tables
+ * (leader_conversation / agent_conversation). This is the source-of-truth signal
+ * — user words, assistant output, tool calls — before any checkpoint compression.
+ */
+export interface TrajectoryTurn {
+    sessionId: string;
+    /** 'leader' for main-agent turns, otherwise the worker agent name. */
+    agent: string;
+    role: string;
+    /** Plain-text rendering of message content (JSON content already flattened). */
+    text: string;
+    /** Compact one-line summary of each tool call (name + truncated input), if any. */
+    toolCalls: string[];
+    /** Unix seconds. */
+    timestamp: number;
+}
+export interface DreamOptions {
+    workspace: string;
+    projectId: string;
+    sessionLookbackDays?: number;
+    maxLines?: number;
+    maxBytes?: number;
+    /** Optional progress sink for TUI/Web maintenance animation. */
+    reporter?: MaintenanceReporter;
+}
+export interface DreamResult {
+    updatedPath: string;
+    sectionsConsolidated: number;
+    linesWritten: number;
+    checkpointsProcessed: number;
+    verification?: {
+        recentSessionCount: number;
+        totalMessages: number;
+        verified: boolean;
+    };
+}
+export type AssetForm = 'skill' | 'command' | 'agent' | 'skip';
+export interface DistillAsset {
+    form: AssetForm;
+    name: string;
+    path: string;
+    content: string;
+    status?: 'created' | 'skipped';
+    reason?: string;
+}
+export interface DistillResult {
+    created: DistillAsset[];
+    skipped: string[];
+    needsMoreEvidence: string[];
+    considered: number;
+    conflicts: string[];
+    invalid: string[];
+    materialStats?: {
+        trajectoryTurns: number;
+        checkpoints: number;
+        progressEntries: number;
+    };
+}
+export interface DistillOptions {
+    workspace: string;
+    projectId: string;
+    sessionLookbackDays?: number;
+    /**
+     * When false (default), generated assets never overwrite an existing file.
+     * Callers can opt in explicitly for controlled regeneration.
+     */
+    allowOverwrite?: boolean;
+    /** Optional progress sink for TUI/Web maintenance animation. */
+    reporter?: MaintenanceReporter;
+}
+/**
+ * Progress sink for dream/distill so the command layer stays decoupled from the
+ * EventEmitter. Callers (dispatcher/MemoryMaintenance) wrap emitter.emit. Each
+ * pipeline stage reports a deterministic, monotonically increasing fraction
+ * (0..1) — fixed per stage, never inferred — plus a human-readable detail.
+ */
+export interface MaintenanceReporter {
+    progress(phase: string, fraction: number, detail: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,10 @@
+/**
+ * Memory FTS type definitions.
+ *
+ * Scopes represent the isolation level of memory entries:
+ * - global: cross-project user preferences
+ * - project: project-specific knowledge
+ * - session: per-session ephemeral data (checkpoints, notes, progress)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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

package/dist/plugins/hooks/ChatTransformHook.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Chat message transform hooks.
+ *
+ * Provides a pipeline that runs before messages are sent to the LLM.
+ * Each hook in the pipeline receives the output of the previous hook,
+ * allowing progressive filtering, modification, or augmentation of messages.
+ */
+import type { ChatMessage } from '../../llm/types.js';
+/**
+ * Input to a chat transform hook.
+ */
+export interface ChatTransformInput {
+    messages: ChatMessage[];
+    sessionId?: string;
+}
+/**
+ * A registered chat message transform hook.
+ *
+ * The transform function receives the current messages array and must return
+ * the (possibly modified) messages array. Hooks run as a pipeline in
+ * registration order: each hook receives the output of the previous one.
+ */
+export interface ChatTransformHook {
+    name: string;
+    transform(input: ChatTransformInput): Promise<ChatMessage[]>;
+}
+/**
+ * Runs chat transform hooks as a sequential pipeline.
+ *
+ * Each hook receives the messages output by the previous hook.
+ * The first hook receives the original messages array.
+ */
+export declare class ChatTransformRunner {
+    private hooks;
+    /**
+     * Register a transform hook (appended to the end of the pipeline).
+     */
+    register(hook: ChatTransformHook): void;
+    /**
+     * Remove a transform hook by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Run all transform hooks in registration order as a pipeline.
+     * Returns the final transformed messages array.
+     */
+    run(input: ChatTransformInput): Promise<ChatMessage[]>;
+    /**
+     * Get the count of registered hooks.
+     */
+    get count(): number;
+    /**
+     * Clear all registered hooks.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ChatTransformHook.d.ts.map

package/dist/plugins/hooks/ChatTransformHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatTransformHook.d.ts","sourceRoot":"","sources":["../../../src/plugins/hooks/ChatTransformHook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAA2B;IAExC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAIvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOjC;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAa5D;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}