gnosys 5.5.0 → 5.7.0

package/dist/lib/chat/commands.js

@@ -0,0 +1,367 @@
+/**
+ * Slash command dispatcher for the chat TUI.
+ *
+ * Each command receives the chat state and returns a result describing what
+ * happened. The TUI translates the result into UI updates (system messages,
+ * exit, conversation buffer changes, etc.). Commands run synchronously when
+ * possible; async ones return a Promise.
+ *
+ * Phase 2 commands: /help, /clear, /history, /read, /list, /tags, /dashboard,
+ * /quit, /provider. Phases 3–7 add /pin, /scope, /recall, /threshold,
+ * /reinforce, /remember, /save-turn, /attach, /focus, /branch, /resume-focus,
+ * /dream-here, /search-chats, /export.
+ */
+// ─── Built-in commands ──────────────────────────────────────────────────
+const helpCmd = {
+    name: "/help",
+    summary: "Show available commands",
+    handler: (_ctx, _args) => {
+        const all = listCommands();
+        const lines = ["Available commands:"];
+        for (const c of all) {
+            const alias = c.aliases?.length ? `  (alias: ${c.aliases.join(", ")})` : "";
+            lines.push(`  ${c.name.padEnd(14)}${c.summary}${alias}`);
+            if (c.usage)
+                lines.push(`                ${c.usage}`);
+        }
+        lines.push("");
+        lines.push("Type any other text to chat with the model.");
+        return { kind: "show", lines };
+    },
+};
+const clearCmd = {
+    name: "/clear",
+    summary: "Clear the visible conversation buffer (session log preserved)",
+    handler: () => ({ kind: "clear-buffer" }),
+};
+const quitCmd = {
+    name: "/quit",
+    aliases: ["/exit", "/q"],
+    summary: "Exit chat (session log preserved)",
+    handler: () => ({ kind: "exit" }),
+};
+const historyCmd = {
+    name: "/history",
+    summary: "Show the visible buffer turn-by-turn",
+    handler: (ctx) => {
+        if (ctx.buffer.length === 0) {
+            return { kind: "show", lines: ["(no turns yet)"] };
+        }
+        const lines = [`Buffer has ${ctx.buffer.length} turn(s):`];
+        ctx.buffer.forEach((t, i) => {
+            const preview = t.text.length > 80 ? t.text.slice(0, 77) + "..." : t.text;
+            lines.push(`  [${i}] ${t.role.padEnd(9)} ${preview}`);
+        });
+        return { kind: "show", lines };
+    },
+};
+const providerCmd = {
+    name: "/provider",
+    usage: "/provider <name> [model]",
+    summary: "Switch LLM provider mid-session (anthropic, openai, groq, ollama, etc.)",
+    handler: (_ctx, args) => {
+        if (args.length === 0) {
+            return { kind: "error", message: "Usage: /provider <name> [model]" };
+        }
+        return { kind: "switch-provider", provider: args[0], model: args[1] };
+    },
+};
+const readCmd = {
+    name: "/read",
+    usage: "/read <memoryId>",
+    summary: "Read a specific memory by ID",
+    handler: async (_ctx, args) => {
+        if (args.length === 0) {
+            return { kind: "error", message: "Usage: /read <memoryId>" };
+        }
+        const { GnosysDB } = await import("../db.js");
+        const db = GnosysDB.openCentral();
+        if (!db.isAvailable()) {
+            db.close();
+            return { kind: "error", message: "Central DB unavailable" };
+        }
+        try {
+            const mem = db.getMemory(args[0]);
+            if (!mem)
+                return { kind: "error", message: `Memory not found: ${args[0]}` };
+            return {
+                kind: "show",
+                lines: [
+                    `# ${mem.title}`,
+                    `id: ${mem.id}`,
+                    `category: ${mem.category}`,
+                    `confidence: ${mem.confidence}`,
+                    `tags: ${mem.tags}`,
+                    ``,
+                    mem.content,
+                ],
+            };
+        }
+        finally {
+            db.close();
+        }
+    },
+};
+const listCmd = {
+    name: "/list",
+    usage: "/list [limit]",
+    summary: "List recent chat sessions",
+    handler: async (_ctx, args) => {
+        const { listSessions } = await import("./session.js");
+        const limit = args[0] ? parseInt(args[0], 10) : 20;
+        const sessions = listSessions().slice(0, limit);
+        if (sessions.length === 0) {
+            return { kind: "show", lines: ["(no sessions yet)"] };
+        }
+        const lines = [`Recent ${sessions.length} session(s):`];
+        for (const s of sessions) {
+            const proj = s.project_id ? s.project_id.slice(0, 8) : "—";
+            const sizeKb = (s.size_bytes / 1024).toFixed(1);
+            lines.push(`  ${s.id.slice(0, 12)}…  ${s.last_active.slice(0, 19)}  proj=${proj}  turns=${s.turns}  ${sizeKb}KB`);
+        }
+        return { kind: "show", lines };
+    },
+};
+const tagsCmd = {
+    name: "/tags",
+    summary: "Show the tag registry for the current store",
+    handler: async () => {
+        const { GnosysResolver } = await import("../resolver.js");
+        const { GnosysTagRegistry } = await import("../tags.js");
+        const r = new GnosysResolver();
+        await r.resolve();
+        const stores = r.getStores();
+        if (stores.length === 0)
+            return { kind: "error", message: "No store found." };
+        const reg = new GnosysTagRegistry(stores[0].path);
+        await reg.load();
+        const all = reg.getAllTags();
+        if (all.length === 0)
+            return { kind: "show", lines: ["(no tags registered)"] };
+        return {
+            kind: "show",
+            lines: [`Tags (${all.length}):`, ...all.map((t) => `  ${t}`)],
+        };
+    },
+};
+const dashboardCmd = {
+    name: "/dashboard",
+    summary: "Show project memory dashboard",
+    handler: async () => {
+        const { GnosysDB } = await import("../db.js");
+        const db = GnosysDB.openCentral();
+        if (!db.isAvailable()) {
+            db.close();
+            return { kind: "error", message: "Central DB unavailable" };
+        }
+        try {
+            const projects = db.getAllProjects();
+            const counts = db.getMemoryCount();
+            const lines = [
+                `Projects:         ${projects.length}`,
+                `Active memories:  ${counts.active}`,
+                `Archived memories: ${counts.archived}`,
+                ``,
+                ...projects.slice(0, 10).map((p) => `  ${p.id.slice(0, 8)}  ${p.name}`),
+            ];
+            return { kind: "show", lines };
+        }
+        finally {
+            db.close();
+        }
+    },
+};
+// ─── Phase 3 commands: recall, pinning, scope, threshold, reinforce ───
+const pinCmd = {
+    name: "/pin",
+    usage: "/pin <memoryId>",
+    summary: "Pin a memory so it's included in every recall (until /unpin)",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /pin <memoryId>" };
+        return { kind: "pin", memoryId: args[0] };
+    },
+};
+const unpinCmd = {
+    name: "/unpin",
+    usage: "/unpin <memoryId>",
+    summary: "Remove a pinned memory",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /unpin <memoryId>" };
+        return { kind: "unpin", memoryId: args[0] };
+    },
+};
+const scopeCmd = {
+    name: "/scope",
+    usage: "/scope project|user|global|federated",
+    summary: "Change recall scope mid-session (default: federated)",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /scope project|user|global|federated" };
+        const valid = ["project", "user", "global", "federated"];
+        if (!valid.includes(args[0])) {
+            return { kind: "error", message: `Invalid scope. Use one of: ${valid.join(", ")}` };
+        }
+        return { kind: "scope", scope: args[0] };
+    },
+};
+const thresholdCmd = {
+    name: "/threshold",
+    usage: "/threshold <0.0-1.0>",
+    summary: "Drop recalled memories below this confidence (0 disables)",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /threshold <0.0-1.0>" };
+        const v = parseFloat(args[0]);
+        if (Number.isNaN(v) || v < 0 || v > 1) {
+            return { kind: "error", message: "Threshold must be between 0.0 and 1.0" };
+        }
+        return { kind: "threshold", value: v };
+    },
+};
+const recallCmd = {
+    name: "/recall",
+    usage: "/recall <query>",
+    summary: "Preview what would be recalled for this query (metadata only, no LLM call)",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /recall <query>" };
+        return { kind: "preview-recall", query: args.join(" ") };
+    },
+};
+const reinforceCmd = {
+    name: "/reinforce",
+    usage: "/reinforce <memoryId>",
+    summary: "Mark a memory as useful — boosts future ranking",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /reinforce <memoryId>" };
+        return { kind: "reinforce", memoryId: args[0] };
+    },
+};
+// ─── Phase 4 commands: memory writing ────────────────────────────────────
+const rememberCmd = {
+    name: "/remember",
+    usage: "/remember <text>",
+    summary: "Save text as a new memory in the current project",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /remember <text>" };
+        return { kind: "remember", text: args.join(" ") };
+    },
+};
+const saveTurnCmd = {
+    name: "/save-turn",
+    summary: "Distill the most recent user+assistant exchange into a memory",
+    handler: () => ({ kind: "save-turn" }),
+};
+const attachCmd = {
+    name: "/attach",
+    usage: "/attach <filePath>",
+    summary: "Ingest a file (PDF, image, audio, video, DOCX, MD) and pin it to this session",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /attach <filePath>" };
+        return { kind: "attach", filePath: args.join(" ") };
+    },
+};
+// ─── Phase 7 commands: focus boundaries ──────────────────────────────────
+const focusCmd = {
+    name: "/focus",
+    usage: "/focus <topic>",
+    summary: "Clear the working buffer and declare a new focus (session log preserved)",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /focus <topic>" };
+        return { kind: "focus", topic: args.join(" ") };
+    },
+};
+const branchCmd = {
+    name: "/branch",
+    summary: "Fork the working buffer — explore a what-if without losing this thread",
+    handler: () => ({ kind: "branch" }),
+};
+const resumeFocusCmd = {
+    name: "/resume-focus",
+    usage: "/resume-focus [topic]",
+    summary: "Restore a prior focus (no arg = pop the most recent branch)",
+    handler: (_ctx, args) => {
+        return { kind: "resume-focus", topic: args[0] };
+    },
+};
+// ─── Phase 8 commands: polish ────────────────────────────────────────────
+const exportSessionCmd = {
+    name: "/export",
+    usage: "/export <file.md>",
+    summary: "Dump the current chat session as markdown",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /export <file.md>" };
+        return { kind: "export-session", filePath: args.join(" ") };
+    },
+};
+const searchChatsCmd = {
+    name: "/search-chats",
+    usage: "/search-chats <query>",
+    summary: "Full-text search across all chat session logs",
+    handler: (_ctx, args) => {
+        if (args.length === 0)
+            return { kind: "error", message: "Usage: /search-chats <query>" };
+        return { kind: "search-chats", query: args.join(" ") };
+    },
+};
+const dreamHereCmd = {
+    name: "/dream-here",
+    summary: "Run a dream cycle scoped to memories surfaced in this session",
+    handler: () => ({ kind: "dream-here" }),
+};
+const REGISTRY = [
+    helpCmd,
+    clearCmd,
+    quitCmd,
+    historyCmd,
+    providerCmd,
+    readCmd,
+    listCmd,
+    tagsCmd,
+    dashboardCmd,
+    pinCmd,
+    unpinCmd,
+    scopeCmd,
+    thresholdCmd,
+    recallCmd,
+    reinforceCmd,
+    rememberCmd,
+    saveTurnCmd,
+    attachCmd,
+    focusCmd,
+    branchCmd,
+    resumeFocusCmd,
+    exportSessionCmd,
+    searchChatsCmd,
+    dreamHereCmd,
+];
+export function listCommands() {
+    return REGISTRY;
+}
+export function findCommand(name) {
+    const lower = name.toLowerCase();
+    return REGISTRY.find((c) => c.name.toLowerCase() === lower ||
+        c.aliases?.some((a) => a.toLowerCase() === lower));
+}
+/** Parse a raw input line and dispatch if it's a slash command. Returns null if it's not a command. */
+export async function dispatchCommand(raw, ctx) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const parts = trimmed.split(/\s+/);
+    const name = parts[0];
+    const args = parts.slice(1);
+    const cmd = findCommand(name);
+    if (!cmd) {
+        return { kind: "error", message: `Unknown command: ${name}. Type /help.` };
+    }
+    return await cmd.handler(ctx, args);
+}
+//# sourceMappingURL=commands.js.map

package/dist/lib/chat/commands.js.map

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

package/dist/lib/chat/focus.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Focus boundaries — replaces the traditional "new chat" model.
+ *
+ * With perfect memory in gnosys, sessions don't need to be containers of
+ * context. The conversation log is the audit trail; focus boundaries are
+ * the working framing. /focus clears the working buffer (what the LLM sees)
+ * but preserves the session log + the prior focus's buffer for /resume-focus.
+ *
+ * /branch is a sibling primitive: same focus, but with the current buffer
+ * preserved so you can explore a hypothetical and come back.
+ *
+ * Auto-summarize fires when the buffer approaches the model's context
+ * window — distills the buffer into a memory, replaces it with a single
+ * system reference. Transparent to the user.
+ */
+import { Turn } from "./types.js";
+export interface FocusSnapshot {
+    /** Focus name. */
+    topic: string;
+    /** When this snapshot was created. */
+    ts: string;
+    /** Conversation buffer at the moment of the snapshot. */
+    buffer: Turn[];
+    /** True for snapshots created by /branch (not /focus). */
+    branched?: boolean;
+}
+export interface FocusState {
+    /** Currently declared focus (null = "general" / no focus declared). */
+    current: string | null;
+    /** Snapshots keyed by topic. /focus saves the prior focus here before clearing. */
+    snapshots: Map<string, FocusSnapshot>;
+    /** Branch stack — LIFO of forked buffers from /branch. */
+    branches: FocusSnapshot[];
+}
+export declare function newFocusState(): FocusState;
+/**
+ * Apply /focus — save current state under the prior focus name, then clear.
+ * Returns the new state and the new (empty) buffer.
+ */
+export declare function applyFocus(state: FocusState, buffer: Turn[], newTopic: string, nowIso: string): {
+    state: FocusState;
+    buffer: Turn[];
+    previousTopic: string | null;
+};
+/** Apply /branch — preserve buffer onto the branch stack, keep editing same buffer. */
+export declare function applyBranch(state: FocusState, buffer: Turn[], nowIso: string): FocusState;
+/**
+ * Apply /resume-focus — load a snapshot back into the buffer.
+ * Returns null if no snapshot exists for the requested topic.
+ */
+export declare function applyResumeFocus(state: FocusState, buffer: Turn[], topic: string, nowIso: string): {
+    state: FocusState;
+    buffer: Turn[];
+} | null;
+/** Pop the most recent branch off the stack and restore it. Returns null when empty. */
+export declare function popBranch(state: FocusState): {
+    state: FocusState;
+    buffer: Turn[];
+    topic: string;
+} | null;
+/** Rough token estimate — 1 token ≈ 4 chars for English / code. */
+export declare function estimateTokens(buffer: Turn[]): number;
+/** Threshold check: returns true when the buffer is near the context window cap. */
+export declare function shouldAutoSummarize(buffer: Turn[], contextWindowTokens: number, ratio?: number): boolean;
+/**
+ * Build the prompt that asks the LLM to distill a buffer.
+ * Used in Phase 7's auto-summarize and exposed for /save-turn-style flows.
+ */
+export declare function buildSummaryPrompt(buffer: Turn[], focus: string | null): string;
+//# sourceMappingURL=focus.d.ts.map

package/dist/lib/chat/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/focus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mFAAmF;IACnF,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,IAAI,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAmBrE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAWzF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,IAAI,EAAE,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,GAAG,IAAI,CAe9C;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxG;AAID,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAIrD;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAErG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAkB/E"}

package/dist/lib/chat/focus.js

@@ -0,0 +1,120 @@
+/**
+ * Focus boundaries — replaces the traditional "new chat" model.
+ *
+ * With perfect memory in gnosys, sessions don't need to be containers of
+ * context. The conversation log is the audit trail; focus boundaries are
+ * the working framing. /focus clears the working buffer (what the LLM sees)
+ * but preserves the session log + the prior focus's buffer for /resume-focus.
+ *
+ * /branch is a sibling primitive: same focus, but with the current buffer
+ * preserved so you can explore a hypothetical and come back.
+ *
+ * Auto-summarize fires when the buffer approaches the model's context
+ * window — distills the buffer into a memory, replaces it with a single
+ * system reference. Transparent to the user.
+ */
+export function newFocusState() {
+    return { current: null, snapshots: new Map(), branches: [] };
+}
+/**
+ * Apply /focus — save current state under the prior focus name, then clear.
+ * Returns the new state and the new (empty) buffer.
+ */
+export function applyFocus(state, buffer, newTopic, nowIso) {
+    const previousTopic = state.current;
+    const newSnapshots = new Map(state.snapshots);
+    // Save current buffer under the prior focus (skip if there's nothing to save)
+    if (buffer.length > 0) {
+        const key = previousTopic ?? "general";
+        newSnapshots.set(key, {
+            topic: key,
+            ts: nowIso,
+            buffer,
+        });
+    }
+    return {
+        state: { ...state, current: newTopic, snapshots: newSnapshots },
+        buffer: [],
+        previousTopic,
+    };
+}
+/** Apply /branch — preserve buffer onto the branch stack, keep editing same buffer. */
+export function applyBranch(state, buffer, nowIso) {
+    const branches = [
+        ...state.branches,
+        {
+            topic: state.current ?? "general",
+            ts: nowIso,
+            buffer: [...buffer],
+            branched: true,
+        },
+    ];
+    return { ...state, branches };
+}
+/**
+ * Apply /resume-focus — load a snapshot back into the buffer.
+ * Returns null if no snapshot exists for the requested topic.
+ */
+export function applyResumeFocus(state, buffer, topic, nowIso) {
+    const snap = state.snapshots.get(topic);
+    if (!snap)
+        return null;
+    // Save current buffer under the active focus before swapping
+    const newSnapshots = new Map(state.snapshots);
+    if (buffer.length > 0 && state.current) {
+        newSnapshots.set(state.current, { topic: state.current, ts: nowIso, buffer });
+    }
+    newSnapshots.delete(topic); // consumed
+    return {
+        state: { ...state, current: topic, snapshots: newSnapshots },
+        buffer: [...snap.buffer],
+    };
+}
+/** Pop the most recent branch off the stack and restore it. Returns null when empty. */
+export function popBranch(state) {
+    if (state.branches.length === 0)
+        return null;
+    const last = state.branches[state.branches.length - 1];
+    const branches = state.branches.slice(0, -1);
+    return {
+        state: { ...state, current: last.topic, branches },
+        buffer: [...last.buffer],
+        topic: last.topic,
+    };
+}
+// ─── Auto-summarize ──────────────────────────────────────────────────────
+/** Rough token estimate — 1 token ≈ 4 chars for English / code. */
+export function estimateTokens(buffer) {
+    let chars = 0;
+    for (const t of buffer)
+        chars += t.text.length;
+    return Math.ceil(chars / 4);
+}
+/** Threshold check: returns true when the buffer is near the context window cap. */
+export function shouldAutoSummarize(buffer, contextWindowTokens, ratio = 0.8) {
+    return estimateTokens(buffer) >= contextWindowTokens * ratio;
+}
+/**
+ * Build the prompt that asks the LLM to distill a buffer.
+ * Used in Phase 7's auto-summarize and exposed for /save-turn-style flows.
+ */
+export function buildSummaryPrompt(buffer, focus) {
+    const transcript = buffer
+        .map((t) => {
+        if (t.role === "user")
+            return `User: ${t.text}`;
+        if (t.role === "assistant")
+            return `Assistant: ${t.text}`;
+        return "";
+    })
+        .filter((s) => s.length > 0)
+        .join("\n\n");
+    const focusLine = focus ? `Focus: ${focus}\n\n` : "";
+    return `${focusLine}Distill this chat transcript into a single concise memory the user can reference later. Capture decisions made, conclusions reached, and open questions surfaced. Skip pleasantries.
+
+Transcript:
+${transcript}
+
+Output the distilled memory as plain markdown. No fences, no commentary.`;
+}
+//# sourceMappingURL=focus.js.map

package/dist/lib/chat/focus.js.map

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

package/dist/lib/chat/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Chat orchestrator — the entry point invoked by `gnosys chat`.
+ *
+ * Phase 2 responsibilities:
+ *   - Start or resume a session (writes start event to log)
+ *   - Resolve project context (auto-detect from cwd)
+ *   - Pick the LLM provider/model
+ *   - Mount the ink ChatApp
+ *   - On exit, flush a session_end event
+ */
+import { GnosysConfig } from "../config.js";
+import { SessionEvent } from "./session.js";
+import { Turn } from "./types.js";
+export interface StartChatOptions {
+    config: GnosysConfig;
+    resume?: string;
+    projectId?: string;
+    providerName?: string;
+    modelName?: string;
+}
+/** Reconstruct the conversation buffer from session log events. */
+export declare function bufferFromEvents(events: SessionEvent[]): Turn[];
+/**
+ * Start an interactive chat. Mounts the ink TUI, blocks until /quit or Ctrl-C.
+ * Lazily imports React/ink so non-chat CLI commands aren't paying for them.
+ */
+export declare function startChat(opts: StartChatOptions): Promise<void>;
+/** Print recent sessions to stdout (for `gnosys chat --list`). */
+export declare function printSessionList(limit?: number): void;
+/** Print search results across all session logs (for `gnosys chat --search`). */
+export declare function printSearchResults(query: string, limit?: number): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAML,YAAY,EACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,CAgB/D;AAmBD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DrE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,IAAI,CAcjD;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,CA2BlE"}