trellis-hgl-core 0.6.0-beta.18

package/dist/mem/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/mem/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAGnD;AAED;;;8EAG8E;AAC9E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAYpD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,EAAE,EAAE,MAAM,EACV,WAAW,SAAI,EACf,UAAU,SAAM,GACf,SAAS,CAqFX"}

package/dist/mem/search.js

@@ -0,0 +1,125 @@
+/**
+ * Search scoring and text matching over cleaned dialogue.
+ */
+/**
+ * Weighted-density relevance score:
+ *   `(3 * userCount + asstCount) / totalTurns`
+ * Higher = the session is more topically concentrated on the query AND the
+ * user themselves brought it up (user hits weighted ×3 — the user's own words
+ * anchor "what they actually cared about"; assistant elaboration is downstream
+ * noise). Normalized by `totalTurns` so a tight short session can outrank a
+ * sprawling long one.
+ */
+export function relevanceScore(h) {
+    if (h.totalTurns === 0)
+        return 0;
+    return (3 * h.userCount + h.asstCount) / h.totalTurns;
+}
+/** Find the paragraph-aligned chunk surrounding a hit position. A "chunk" is
+ * the contiguous text bounded by the nearest blank-line breaks (`\n\n`) on
+ * either side. If the natural paragraph exceeds `maxChars`, fall back to a
+ * centered char window — and report the truncation so callers can mark it. */
+export function chunkAround(text, hitIdx, maxChars) {
+    const startPara = text.lastIndexOf("\n\n", hitIdx);
+    let start = startPara === -1 ? 0 : startPara + 2;
+    const endPara = text.indexOf("\n\n", hitIdx);
+    let end = endPara === -1 ? text.length : endPara;
+    let truncated = false;
+    if (end - start > maxChars) {
+        start = Math.max(0, hitIdx - Math.floor(maxChars / 2));
+        end = Math.min(text.length, hitIdx + Math.ceil(maxChars / 2));
+        truncated = true;
+    }
+    return { start, end, truncated };
+}
+/**
+ * Multi-token AND grep over cleaned dialogue. Whitespace-split tokens; a turn
+ * matches iff every token (case-insensitive) appears in it. `count` is the
+ * total occurrence count across all tokens within matching turns. Excerpts are
+ * paragraph-aligned chunks around each hit, deduped by chunk start; user-role
+ * chunks are listed before assistant chunks.
+ */
+export function searchInDialogue(turns, kw, maxExcerpts = 3, chunkChars = 400) {
+    const tokens = kw.toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) {
+        return {
+            count: 0,
+            userCount: 0,
+            asstCount: 0,
+            totalTurns: turns.length,
+            excerpts: [],
+        };
+    }
+    let userCount = 0;
+    let asstCount = 0;
+    const userExcerpts = [];
+    const asstExcerpts = [];
+    for (const t of turns) {
+        const hay = t.text.toLowerCase();
+        if (!tokens.every((tok) => hay.includes(tok)))
+            continue;
+        const hitPositions = [];
+        const tokenFreq = new Map();
+        let turnHits = 0;
+        for (const tok of tokens) {
+            let from = 0;
+            let n = 0;
+            while (true) {
+                const idx = hay.indexOf(tok, from);
+                if (idx === -1)
+                    break;
+                n++;
+                turnHits++;
+                hitPositions.push({ idx, tok });
+                from = idx + tok.length;
+            }
+            tokenFreq.set(tok, n);
+        }
+        if (t.role === "user")
+            userCount += turnHits;
+        else
+            asstCount += turnHits;
+        hitPositions.sort((a, b) => a.idx - b.idx);
+        const candidates = [];
+        const seenStarts = new Set();
+        for (const { idx, tok } of hitPositions) {
+            const { start, end, truncated } = chunkAround(t.text, idx, chunkChars);
+            if (seenStarts.has(start))
+                continue;
+            seenStarts.add(start);
+            const slice = hay.slice(start, end);
+            const coverage = tokens.filter((tk) => slice.includes(tk)).length;
+            const rarity = 1 / (tokenFreq.get(tok) ?? 1);
+            candidates.push({ start, end, truncated, coverage, rarity });
+        }
+        candidates.sort((a, b) => {
+            if (b.coverage !== a.coverage)
+                return b.coverage - a.coverage;
+            if (b.rarity !== a.rarity)
+                return b.rarity - a.rarity;
+            return a.start - b.start;
+        });
+        for (const c of candidates) {
+            let snippet = t.text.slice(c.start, c.end).trim();
+            if (c.truncated) {
+                if (c.start > 0)
+                    snippet = "…" + snippet;
+                if (c.end < t.text.length)
+                    snippet += "…";
+            }
+            (t.role === "user" ? userExcerpts : asstExcerpts).push({
+                role: t.role,
+                snippet,
+            });
+        }
+    }
+    const excerpts = [...userExcerpts, ...asstExcerpts].slice(0, maxExcerpts);
+    return {
+        count: userCount + asstCount,
+        userCount,
+        asstCount,
+        totalTurns: turns.length,
+        excerpts,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/mem/search.js.map

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

package/dist/mem/sessions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session orchestration: source fan-out, platform dispatch, sub-agent child
+ * merging, session lookup, phase slicing, and the public `listMemSessions`,
+ * `searchMemSessions`, and `extractMemDialogue` entry points.
+ */
+import type { DialogueTurn, ExtractMemDialogueOptions, ListMemSessionsOptions, MemExtractResult, MemFilter, MemSearchResult, MemSessionInfo, SearchMemSessionsOptions } from "./types.js";
+/** Internal wide limit — `limit` only caps display; search recall and session
+ * lookup must scan everything. */
+export declare const WIDE_LIMIT = 1000000;
+/** Thrown by `readMemContext` / `extractMemDialogue` when the requested
+ * session id cannot be resolved. */
+export declare class MemSessionNotFoundError extends Error {
+    readonly sessionId: string;
+    constructor(sessionId: string);
+}
+/** Fill platform / limit defaults so internal helpers see a complete filter. */
+export declare function resolveFilter(filter?: MemFilter): MemFilter;
+/** Fan out to every in-scope platform, merge by recency, cap at `f.limit`. */
+export declare function listAll(f: MemFilter): MemSessionInfo[];
+declare function extractDialogue(s: MemSessionInfo): DialogueTurn[];
+/** Build a parent → descendants index (transitively flattened) for OpenCode
+ * sub-agent chains. Other platforms have no native `parent_id`. */
+declare function buildChildIndex(sessions: readonly MemSessionInfo[]): Map<string, MemSessionInfo[]>;
+/** Resolve a session by exact id or id prefix, scanning every project. */
+export declare function findSessionById(id: string, f: MemFilter): MemSessionInfo | undefined;
+/** List session metadata across Claude / Codex / OpenCode, sorted by recency
+ * and capped at the filter's `limit` (default 50). */
+export declare function listMemSessions(options?: ListMemSessionsOptions): MemSessionInfo[];
+/** Multi-token AND grep over cleaned dialogue across all matching sessions,
+ * ranked by weighted-density relevance. `matches` is capped at the filter's
+ * `limit`; `totalMatches` is the full match count. */
+export declare function searchMemSessions(options: SearchMemSessionsOptions): MemSearchResult;
+/** Dump cleaned dialogue for one session, optionally sliced by brainstorm
+ * phase and filtered by a multi-token AND `grep`. */
+export declare function extractMemDialogue(options: ExtractMemDialogueOptions): MemExtractResult;
+export { extractDialogue, buildChildIndex };
+//# sourceMappingURL=sessions.d.ts.map

package/dist/mem/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/mem/sessions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EAEtB,gBAAgB,EAChB,SAAS,EAGT,eAAe,EACf,cAAc,EAGd,wBAAwB,EAEzB,MAAM,YAAY,CAAC;AAEpB;kCACkC;AAClC,eAAO,MAAM,UAAU,UAAY,CAAC;AAEpC;oCACoC;AACpC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,SAAS,EAAE,MAAM;CAK9B;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAQ3D;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,GAAG,cAAc,EAAE,CAYtD;AAED,iBAAS,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE,CAS1D;AA2BD;mEACmE;AACnE,iBAAS,eAAe,CACtB,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAqB/B;AAcD,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,SAAS,GACX,cAAc,GAAG,SAAS,CAI5B;AAyFD;sDACsD;AACtD,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,EAAE,CAElB;AAED;;sDAEsD;AACtD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,eAAe,CA0CjB;AAED;qDACqD;AACrD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,CA2BlB;AAGD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/mem/sessions.js

@@ -0,0 +1,270 @@
+/**
+ * Session orchestration: source fan-out, platform dispatch, sub-agent child
+ * merging, session lookup, phase slicing, and the public `listMemSessions`,
+ * `searchMemSessions`, and `extractMemDialogue` entry points.
+ */
+import { claudeExtractDialogue, claudeListSessions, claudeSearch, collectClaudeTurnsAndEvents, } from "./adapters/claude.js";
+import { codexExtractDialogue, codexListSessions, codexSearch, collectCodexTurnsAndEvents, } from "./adapters/codex.js";
+import { opencodeExtractDialogue, opencodeListSessions, opencodeSearch, } from "./adapters/opencode.js";
+import { buildBrainstormWindows } from "./phase.js";
+import { relevanceScore, searchInDialogue } from "./search.js";
+/** Internal wide limit — `limit` only caps display; search recall and session
+ * lookup must scan everything. */
+export const WIDE_LIMIT = 1_000_000;
+/** Thrown by `readMemContext` / `extractMemDialogue` when the requested
+ * session id cannot be resolved. */
+export class MemSessionNotFoundError extends Error {
+    sessionId;
+    constructor(sessionId) {
+        super(`mem session not found: ${sessionId}`);
+        this.name = "MemSessionNotFoundError";
+        this.sessionId = sessionId;
+    }
+}
+/** Fill platform / limit defaults so internal helpers see a complete filter. */
+export function resolveFilter(filter) {
+    return {
+        platform: filter?.platform ?? "all",
+        since: filter?.since,
+        until: filter?.until,
+        cwd: filter?.cwd,
+        limit: filter?.limit ?? 50,
+    };
+}
+/** Fan out to every in-scope platform, merge by recency, cap at `f.limit`. */
+export function listAll(f) {
+    const all = [];
+    if (f.platform === "all" || f.platform === "claude")
+        all.push(...claudeListSessions(f));
+    if (f.platform === "all" || f.platform === "codex")
+        all.push(...codexListSessions(f));
+    if (f.platform === "all" || f.platform === "opencode")
+        all.push(...opencodeListSessions(f));
+    all.sort((a, b) => (b.updated ?? b.created ?? "").localeCompare(a.updated ?? a.created ?? ""));
+    return all.slice(0, f.limit);
+}
+function extractDialogue(s) {
+    switch (s.platform) {
+        case "claude":
+            return claudeExtractDialogue(s);
+        case "codex":
+            return codexExtractDialogue(s);
+        case "opencode":
+            return opencodeExtractDialogue(s);
+    }
+}
+function searchSession(s, kw) {
+    switch (s.platform) {
+        case "claude":
+            return claudeSearch(s, kw);
+        case "codex":
+            return codexSearch(s, kw);
+        case "opencode":
+            return opencodeSearch(kw);
+    }
+}
+function collectTurnsAndEvents(s) {
+    switch (s.platform) {
+        case "claude":
+            return collectClaudeTurnsAndEvents(s);
+        case "codex":
+            return collectCodexTurnsAndEvents(s);
+        case "opencode":
+            return { turns: opencodeExtractDialogue(s), events: [] };
+    }
+}
+/** Build a parent → descendants index (transitively flattened) for OpenCode
+ * sub-agent chains. Other platforms have no native `parent_id`. */
+function buildChildIndex(sessions) {
+    const directChildren = new Map();
+    for (const s of sessions) {
+        if (!s.parent_id)
+            continue;
+        const list = directChildren.get(s.parent_id) ?? [];
+        list.push(s);
+        directChildren.set(s.parent_id, list);
+    }
+    const out = new Map();
+    for (const [pid] of directChildren) {
+        const stack = [...(directChildren.get(pid) ?? [])];
+        const flat = [];
+        while (stack.length) {
+            const cur = stack.pop();
+            if (cur === undefined)
+                break;
+            flat.push(cur);
+            for (const c of directChildren.get(cur.id) ?? [])
+                stack.push(c);
+        }
+        out.set(pid, flat);
+    }
+    return out;
+}
+function searchSessionWithChildren(s, kw, childIndex) {
+    const children = childIndex.get(s.id) ?? [];
+    if (children.length === 0)
+        return searchSession(s, kw);
+    const merged = [...extractDialogue(s)];
+    for (const c of children)
+        merged.push(...extractDialogue(c));
+    return searchInDialogue(merged, kw);
+}
+/** Resolve a session by exact id or id prefix, scanning every project. */
+export function findSessionById(id, f) {
+    const wide = { ...f, cwd: undefined, limit: WIDE_LIMIT };
+    const all = listAll(wide);
+    return all.find((s) => s.id === id) ?? all.find((s) => s.id.startsWith(id));
+}
+/** Slice cleaned dialogue by phase. Claude / Codex have native boundary
+ * detection; OpenCode degrades to "all turns + warning". */
+function sliceMemPhase(s, phase) {
+    const warnings = [];
+    if (phase === "all" || s.platform === "opencode") {
+        if (phase !== "all" && s.platform === "opencode") {
+            warnings.push({
+                code: "opencode-phase-unsupported",
+                message: `--phase ${phase} on platform=opencode is not yet supported; ` +
+                    `returning full dialogue.`,
+            });
+        }
+        const turns = extractDialogue(s);
+        return {
+            groups: [{ label: null, turns }],
+            windows: [],
+            totalTurns: turns.length,
+            warnings,
+        };
+    }
+    const { turns, events } = collectTurnsAndEvents(s);
+    const windows = buildBrainstormWindows(events, turns.length);
+    if (phase === "brainstorm") {
+        if (windows.length === 0) {
+            warnings.push({
+                code: "no-brainstorm-boundary",
+                message: `no task.py create/start boundary found in session — returning full dialogue.`,
+            });
+            return {
+                groups: [{ label: null, turns }],
+                windows: [],
+                totalTurns: turns.length,
+                warnings,
+            };
+        }
+        const groups = windows.map((w) => ({
+            label: w.label,
+            turns: turns.slice(w.startTurn, w.endTurn),
+        }));
+        return { groups, windows, totalTurns: turns.length, warnings };
+    }
+    // phase === "implement": all turns NOT inside any brainstorm window.
+    if (windows.length === 0) {
+        warnings.push({
+            code: "no-brainstorm-boundary",
+            message: `no task.py create/start boundary found in session — implement phase is empty.`,
+        });
+        return {
+            groups: [{ label: null, turns: [] }],
+            windows: [],
+            totalTurns: turns.length,
+            warnings,
+        };
+    }
+    const covered = new Set();
+    for (const w of windows) {
+        for (let i = w.startTurn; i < w.endTurn; i++)
+            covered.add(i);
+    }
+    const implementTurns = [];
+    for (let i = 0; i < turns.length; i++) {
+        if (!covered.has(i)) {
+            const t = turns[i];
+            if (t)
+                implementTurns.push(t);
+        }
+    }
+    return {
+        groups: [{ label: null, turns: implementTurns }],
+        windows,
+        totalTurns: turns.length,
+        warnings,
+    };
+}
+// ---------- public API ----------
+/** List session metadata across Claude / Codex / OpenCode, sorted by recency
+ * and capped at the filter's `limit` (default 50). */
+export function listMemSessions(options) {
+    return listAll(resolveFilter(options?.filter));
+}
+/** Multi-token AND grep over cleaned dialogue across all matching sessions,
+ * ranked by weighted-density relevance. `matches` is capped at the filter's
+ * `limit`; `totalMatches` is the full match count. */
+export function searchMemSessions(options) {
+    const f = resolveFilter(options.filter);
+    const kw = options.keyword;
+    const includeChildren = options.includeChildren === true;
+    const candidates = listAll({ ...f, limit: WIDE_LIMIT });
+    const childIndex = includeChildren
+        ? buildChildIndex(candidates)
+        : new Map();
+    const candidateIds = new Set(candidates.map((s) => s.id));
+    const isAbsorbedChild = (s) => includeChildren &&
+        s.parent_id !== undefined &&
+        candidateIds.has(s.parent_id);
+    const matches = [];
+    for (const s of candidates) {
+        if (isAbsorbedChild(s))
+            continue;
+        const hit = includeChildren
+            ? searchSessionWithChildren(s, kw, childIndex)
+            : searchSession(s, kw);
+        if (hit.count === 0)
+            continue;
+        matches.push({
+            session: s,
+            hit,
+            score: relevanceScore(hit),
+            descendantsMerged: childIndex.get(s.id)?.length ?? 0,
+        });
+    }
+    matches.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        if (b.hit.count !== a.hit.count)
+            return b.hit.count - a.hit.count;
+        return (b.session.updated ?? b.session.created ?? "").localeCompare(a.session.updated ?? a.session.created ?? "");
+    });
+    return {
+        matches: matches.slice(0, f.limit),
+        totalMatches: matches.length,
+        warnings: [],
+    };
+}
+/** Dump cleaned dialogue for one session, optionally sliced by brainstorm
+ * phase and filtered by a multi-token AND `grep`. */
+export function extractMemDialogue(options) {
+    const f = resolveFilter(options.filter);
+    const phase = options.phase ?? "all";
+    const s = findSessionById(options.sessionId, f);
+    if (!s)
+        throw new MemSessionNotFoundError(options.sessionId);
+    const slice = sliceMemPhase(s, phase);
+    const grepLc = typeof options.grep === "string" ? options.grep.toLowerCase() : undefined;
+    const filterTurns = (turns) => grepLc ? turns.filter((t) => t.text.toLowerCase().includes(grepLc)) : turns;
+    const groups = slice.groups.map((g) => ({
+        label: g.label,
+        turns: filterTurns(g.turns),
+    }));
+    const flat = groups.flatMap((g) => g.turns);
+    return {
+        session: s,
+        phase,
+        windows: slice.windows,
+        totalTurns: slice.totalTurns,
+        groups,
+        turns: flat,
+        warnings: slice.warnings,
+    };
+}
+// Re-exports needed by sibling orchestration modules.
+export { extractDialogue, buildChildIndex };
+//# sourceMappingURL=sessions.js.map

package/dist/mem/sessions.js.map

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

package/dist/mem/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Public input / output types for `@mindfoldhq/trellis-core/mem`.
+ *
+ * This model serves persisted AI-session retrieval and dialogue-context
+ * extraction only. It is intentionally separate from the channel event schema:
+ * channel keeps its own event log as the source of truth, and v1 mem never
+ * reads channel events.
+ */
+export type MemSourceKind = "claude" | "codex" | "opencode";
+export type MemSourceFilter = MemSourceKind | "all";
+export type MemPhase = "brainstorm" | "implement" | "all";
+export type DialogueRole = "user" | "assistant";
+export interface DialogueTurn {
+    role: DialogueRole;
+    text: string;
+}
+/**
+ * Cross-cutting session selection filter. Every field is optional — `platform`
+ * defaults to `"all"` and `limit` defaults to `50` when omitted. `cwd` scopes
+ * to a project directory (and its descendants); leave it `undefined` for a
+ * global search.
+ */
+export interface MemFilter {
+    platform?: MemSourceFilter;
+    since?: Date;
+    until?: Date;
+    cwd?: string;
+    limit?: number;
+}
+/** Unified session metadata across platforms. JSON field names (`platform`,
+ * `parent_id`, `filePath`) are kept stable for user-visible output. */
+export interface MemSessionInfo {
+    platform: MemSourceKind;
+    id: string;
+    title?: string;
+    cwd?: string;
+    created?: string;
+    updated?: string;
+    filePath: string;
+    /** OpenCode only: parent session id (sub-agent chain). */
+    parent_id?: string;
+}
+export interface SearchExcerpt {
+    role: DialogueRole;
+    snippet: string;
+}
+/** Per-session search hit: occurrence counts plus paragraph-aligned excerpts. */
+export interface SearchHit {
+    /** Total token occurrences across all matching turns. */
+    count: number;
+    /** Breakdown: user-turn occurrences. */
+    userCount: number;
+    /** Breakdown: assistant-turn occurrences. */
+    asstCount: number;
+    /** Size of the cleaned dialogue (denominator for relevance density). */
+    totalTurns: number;
+    excerpts: SearchExcerpt[];
+}
+/** Non-fatal warning surfaced from a core call — the caller decides how (and
+ * whether) to render it. */
+export interface MemWarning {
+    code: string;
+    message: string;
+}
+export interface MemSearchMatch {
+    session: MemSessionInfo;
+    /** Weighted-density relevance score. */
+    score: number;
+    hit: SearchHit;
+    /** Sub-agent descendants merged into this match (OpenCode `--include-children`). */
+    descendantsMerged: number;
+}
+export interface MemSearchResult {
+    /** Ranked matches, already capped to the filter's `limit`. */
+    matches: MemSearchMatch[];
+    /** Total matching sessions before the display cap. */
+    totalMatches: number;
+    warnings: MemWarning[];
+}
+export interface MemContextTurn {
+    idx: number;
+    role: DialogueRole;
+    text: string;
+    isHit: boolean;
+}
+export interface MemContextResult {
+    session: MemSessionInfo;
+    query?: string;
+    totalTurns: number;
+    totalHitTurns: number;
+    mergedChildren: number;
+    budgetUsed: number;
+    maxChars: number;
+    turns: MemContextTurn[];
+    warnings: MemWarning[];
+}
+export interface BrainstormWindow {
+    label: string;
+    /** inclusive */
+    startTurn: number;
+    /** exclusive */
+    endTurn: number;
+}
+export interface MemDialogueGroup {
+    label: string | null;
+    turns: DialogueTurn[];
+}
+export interface MemExtractResult {
+    session: MemSessionInfo;
+    phase: MemPhase;
+    windows: BrainstormWindow[];
+    /** Total turns in the underlying cleaned dialogue, before any `grep` filter. */
+    totalTurns: number;
+    /** Per-window labeled groups (single unlabeled group for `phase: "all"`). */
+    groups: MemDialogueGroup[];
+    /** Flat concatenation of all groups' turns. */
+    turns: DialogueTurn[];
+    warnings: MemWarning[];
+}
+export interface MemProjectSummary {
+    cwd: string;
+    last_active: string;
+    sessions: number;
+    by_platform: Record<MemSourceKind, number>;
+}
+/** Parsed `task.py create|start` invocation recovered from a raw shell call. */
+export type ParsedTaskPyCommand = {
+    action: "create";
+    slug?: string;
+    titleArg?: string;
+} | {
+    action: "start";
+    taskDir?: string;
+};
+export interface TaskPyEvent {
+    action: "create" | "start";
+    timestamp: string;
+    /** Index into the cleaned `DialogueTurn[]` at the time the shell call ran. */
+    turnIndex: number;
+    slug?: string;
+    taskDir?: string;
+}
+export interface ListMemSessionsOptions {
+    filter?: MemFilter;
+}
+export interface SearchMemSessionsOptions {
+    keyword: string;
+    filter?: MemFilter;
+    /** Merge OpenCode sub-agent descendants into their parent before searching. */
+    includeChildren?: boolean;
+}
+export interface ReadMemContextOptions {
+    sessionId: string;
+    filter?: MemFilter;
+    /** Multi-token AND keyword used to rank and anchor hit turns. */
+    grep?: string;
+    /** Number of hit turns to surface (default 3). */
+    turns?: number;
+    /** Turns of surrounding context on either side of each hit (default 1). */
+    around?: number;
+    /** Total character budget (default 6000). */
+    maxChars?: number;
+    includeChildren?: boolean;
+}
+export interface ExtractMemDialogueOptions {
+    sessionId: string;
+    filter?: MemFilter;
+    /** Phase slice (default `"all"`). */
+    phase?: MemPhase;
+    /** Multi-token AND substring filter applied after phase slicing. */
+    grep?: string;
+}
+export interface ListMemProjectsOptions {
+    filter?: MemFilter;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/mem/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public input / output types for `@mindfoldhq/trellis-core/mem`.
+ *
+ * This model serves persisted AI-session retrieval and dialogue-context
+ * extraction only. It is intentionally separate from the channel event schema:
+ * channel keeps its own event log as the source of truth, and v1 mem never
+ * reads channel events.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mem/types.js.map

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