@marifold/core 0.60.0

package/dist/search/DuckDuckGoBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuckDuckGoBackend.js","sourceRoot":"","sources":["../../src/search/DuckDuckGoBackend.ts"],"names":[],"mappings":";;;AAAA,uDAAuE;AAGvE,MAAM,MAAM,GAAG,OAAO,CAAC;AACvB,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAQ9B;;;;;GAKG;AACH;IACmB,KAAK,CAAqB;IAE3C,YAAY,OAAO,GAA6B,EAAE;QAChD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,SAAS,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAU,GAAG,mBAAmB;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAS,EAAC,KAAK,EAAE;YACtC,UAAU,EAAE,iCAAc,CAAC,QAAQ;YACnC,MAAM;SACP,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;aAC5B,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;aACjC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACd,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YACpC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;YACrB,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;SAC7C,CAAC,CAAC,CAAC;IACR,CAAC;CACF;;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/dist/search/FirecrawlBackend.d.ts

@@ -0,0 +1,28 @@
+import { SearchBackend, SearchResultItem } from './SearchBackend';
+export interface FirecrawlBackendOptions {
+    /** API key (BYOK). When absent, falls back to the env var named by
+     * `apiKeyEnv`, then to keyless requests (rate-limited by Firecrawl). */
+    apiKey?: string;
+    apiKeyEnv?: string;
+    /** Scrape each result into LLM-ready markdown. Firecrawl charges more for
+     * this; off by default. */
+    scrape?: boolean;
+    /** HTTP proxy, e.g. "http://127.0.0.1:7890". Falls back to
+     * HTTPS_PROXY/https_proxy. Applied best-effort via undici when available. */
+    proxy?: string;
+    maxResults?: number;
+}
+/**
+ * Firecrawl search backend (https://firecrawl.dev). Searches the web and, when
+ * `scrape` is set, returns each result as clean LLM-ready markdown. Works
+ * keyless with provider rate limits; a key (BYOK) lifts them.
+ */
+export declare class FirecrawlBackend implements SearchBackend {
+    private readonly apiKey;
+    private readonly scrape;
+    private readonly proxy;
+    private readonly maxResults;
+    constructor(options?: FirecrawlBackendOptions);
+    search(query: string, maxResults?: number): Promise<SearchResultItem[]>;
+}
+//# sourceMappingURL=FirecrawlBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FirecrawlBackend.d.ts","sourceRoot":"","sources":["../../src/search/FirecrawlBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMlE,MAAM,WAAW,uBAAuB;IACtC;4EACwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+BAC2B;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;iFAC6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAAY,OAAO,GAAE,uBAA4B,EAMhD;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkCrF;CACF"}

package/dist/search/FirecrawlBackend.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirecrawlBackend = void 0;
+const proxy_1 = require("../util/proxy");
+const FIRECRAWL_SEARCH_URL = 'https://api.firecrawl.dev/v2/search';
+const DEFAULT_MAX_RESULTS = 5;
+/**
+ * Firecrawl search backend (https://firecrawl.dev). Searches the web and, when
+ * `scrape` is set, returns each result as clean LLM-ready markdown. Works
+ * keyless with provider rate limits; a key (BYOK) lifts them.
+ */
+class FirecrawlBackend {
+    apiKey;
+    scrape;
+    proxy;
+    maxResults;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey
+            ?? (options.apiKeyEnv ? process.env[options.apiKeyEnv] : undefined);
+        this.scrape = options.scrape ?? false;
+        this.proxy = options.proxy || process.env.HTTPS_PROXY || process.env.https_proxy || undefined;
+        this.maxResults = options.maxResults ?? DEFAULT_MAX_RESULTS;
+    }
+    async search(query, maxResults = this.maxResults) {
+        const limit = Math.max(1, maxResults);
+        const body = {
+            query,
+            limit,
+            sources: ['web'],
+            ...(this.scrape ? { scrapeOptions: { formats: ['markdown'] } } : {}),
+        };
+        const headers = { 'content-type': 'application/json' };
+        if (this.apiKey)
+            headers.authorization = `Bearer ${this.apiKey}`;
+        const init = {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        };
+        const dispatcher = (0, proxy_1.proxyDispatcher)(this.proxy);
+        if (dispatcher)
+            init.dispatcher = dispatcher;
+        const response = await fetch(FIRECRAWL_SEARCH_URL, init);
+        if (!response.ok) {
+            const detail = await safeText(response);
+            throw new Error(`Firecrawl search failed: HTTP ${response.status}${detail ? ` — ${detail}` : ''}`);
+        }
+        const payload = await response.json();
+        return extractResults(payload.data)
+            .slice(0, limit)
+            .map(result => ({
+            title: (result.title ?? '').trim(),
+            url: result.url ?? '',
+            // In scrape mode the markdown body is the LLM-ready value-add; fall back
+            // to the description snippet otherwise.
+            snippet: ((this.scrape ? result.markdown : undefined) ?? result.description ?? '').trim(),
+        }));
+    }
+}
+exports.FirecrawlBackend = FirecrawlBackend;
+/** Firecrawl v2 groups results under `data.web`; v1 returned a flat `data[]`.
+ * Accept either so the backend survives an API version bump. */
+function extractResults(data) {
+    if (Array.isArray(data))
+        return data;
+    return data?.web ?? [];
+}
+async function safeText(response) {
+    try {
+        return (await response.text()).slice(0, 200);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=FirecrawlBackend.js.map

package/dist/search/FirecrawlBackend.js.map

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

package/dist/search/SearchBackend.d.ts

@@ -0,0 +1,18 @@
+export interface SearchResultItem {
+    title: string;
+    url: string;
+    snippet: string;
+}
+/**
+ * Pluggable web search backend. DuckDuckGo scraping is the no-API-key
+ * default, but it is brittle by nature — keep this interface narrow so
+ * Brave/SearXNG/other backends can replace it without touching callers.
+ */
+export interface SearchBackend {
+    search(query: string, maxResults?: number): Promise<SearchResultItem[]>;
+}
+/** Format results as the numbered text block priests injects (search.py). */
+export declare function formatSearchResults(query: string, results: SearchResultItem[]): string;
+/** Wrap raw search results with turn-local instructions for the model. */
+export declare function formatSearchContext(searchResults: string): string;
+//# sourceMappingURL=SearchBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchBackend.d.ts","sourceRoot":"","sources":["../../src/search/SearchBackend.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAStF;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQjE"}

package/dist/search/SearchBackend.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSearchResults = formatSearchResults;
+exports.formatSearchContext = formatSearchContext;
+/** Format results as the numbered text block priests injects (search.py). */
+function formatSearchResults(query, results) {
+    if (results.length === 0) {
+        return `Web search for '${query}' returned no results.`;
+    }
+    const lines = [`## Web search results for: ${query}\n`];
+    results.forEach((result, index) => {
+        lines.push(`${index + 1}. **${result.title}**\n   ${result.url}\n   ${result.snippet}\n`);
+    });
+    return lines.join('\n');
+}
+/** Wrap raw search results with turn-local instructions for the model. */
+function formatSearchContext(searchResults) {
+    return ('## Web search results\n\n'
+        + "Use the following web search results to answer the user's current question. "
+        + 'Do not request another web search for this turn. '
+        + 'If the results are insufficient or irrelevant, say what could not be confirmed.\n\n'
+        + searchResults);
+}
+//# sourceMappingURL=SearchBackend.js.map

package/dist/search/SearchBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchBackend.js","sourceRoot":"","sources":["../../src/search/SearchBackend.ts"],"names":[],"mappings":";;;;AAeA,6EAA6E;AAC7E,6BAAoC,KAAa,EAAE,OAA2B;IAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,KAAK,wBAAwB,CAAC;IAC1D,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,8BAA8B,KAAK,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAG,QAAQ,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,0EAA0E;AAC1E,6BAAoC,aAAqB;IACvD,OAAO,CACL,2BAA2B;UACzB,8EAA8E;UAC9E,mDAAmD;UACnD,qFAAqF;UACrF,aAAa,CAChB,CAAC;AACJ,CAAC"}

package/dist/search/createSearchBackend.d.ts

@@ -0,0 +1,16 @@
+import { MarifoldWebSearchConfig } from '../config/ConfigSchema';
+import { SearchBackend } from './SearchBackend';
+/**
+ * Select the active web-search backend from the resolved [web_search] config.
+ *
+ * Priority is a config-time selection of ONE backend (not a runtime retry
+ * cascade):
+ *   - `firecrawl` → FirecrawlBackend (BYOK; AI-ready scraped results)
+ *   - else        → DuckDuckGoBackend (keyless best-effort floor)
+ *
+ * Future tier-1 "native" model search (provider server-side web_search) resolves
+ * in priest, not here — marifold would simply skip registering its own
+ * web_search tool for such a profile. See docs/roadmap.
+ */
+export declare function createSearchBackend(config: MarifoldWebSearchConfig): SearchBackend;
+//# sourceMappingURL=createSearchBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createSearchBackend.d.ts","sourceRoot":"","sources":["../../src/search/createSearchBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,aAAa,CAWlF"}

package/dist/search/createSearchBackend.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchBackend = createSearchBackend;
+const DuckDuckGoBackend_1 = require("./DuckDuckGoBackend");
+const FirecrawlBackend_1 = require("./FirecrawlBackend");
+/**
+ * Select the active web-search backend from the resolved [web_search] config.
+ *
+ * Priority is a config-time selection of ONE backend (not a runtime retry
+ * cascade):
+ *   - `firecrawl` → FirecrawlBackend (BYOK; AI-ready scraped results)
+ *   - else        → DuckDuckGoBackend (keyless best-effort floor)
+ *
+ * Future tier-1 "native" model search (provider server-side web_search) resolves
+ * in priest, not here — marifold would simply skip registering its own
+ * web_search tool for such a profile. See docs/roadmap.
+ */
+function createSearchBackend(config) {
+    if (config.provider === 'firecrawl') {
+        return new FirecrawlBackend_1.FirecrawlBackend({
+            apiKey: config.apiKey,
+            apiKeyEnv: config.apiKeyEnv,
+            scrape: config.scrape,
+            proxy: config.proxy,
+            maxResults: config.maxResults,
+        });
+    }
+    return new DuckDuckGoBackend_1.DuckDuckGoBackend({ proxy: config.proxy });
+}
+//# sourceMappingURL=createSearchBackend.js.map

package/dist/search/createSearchBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSearchBackend.js","sourceRoot":"","sources":["../../src/search/createSearchBackend.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,yDAAsD;AAGtD;;;;;;;;;;;GAWG;AACH,6BAAoC,MAA+B;IACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,IAAI,mCAAgB,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,qCAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/sessions/ResponseMetrics.d.ts

@@ -0,0 +1,17 @@
+import type { AgentUsage } from '../agent/AgentEvents';
+/**
+ * Durable, content-free metadata for one completed user→assistant exchange.
+ * Stored in a Marifold-owned companion table so Priest's transcript schema
+ * remains untouched and future statistics can aggregate across modes/models.
+ */
+export interface ResponseMetrics {
+    mode: 'agent' | 'chat';
+    provider: string;
+    model: string;
+    think: boolean;
+    startedAt: string;
+    finishedAt: string;
+    latencyMs: number;
+    usage?: AgentUsage;
+}
+//# sourceMappingURL=ResponseMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseMetrics.d.ts","sourceRoot":"","sources":["../../src/sessions/ResponseMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB"}

package/dist/sessions/ResponseMetrics.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ResponseMetrics.js.map

package/dist/sessions/ResponseMetrics.js.map

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

package/dist/sessions/SessionResolver.d.ts

@@ -0,0 +1,135 @@
+import { ImageInput, SQLiteSessionStore } from '@priest-ai/core';
+import { SessionDetail, SessionSummary, SessionTurnSummary } from '../config/ConfigSchema';
+import type { ResponseMetrics } from './ResponseMetrics';
+export interface SessionDisplayUpdate {
+    /** `null` clears a custom title and restores the first-message preview. */
+    title?: string | null;
+    pinned?: boolean;
+    archived?: boolean;
+}
+export interface SessionListOptions {
+    /** Default is active sessions only. */
+    archived?: boolean;
+    /** Case-insensitive search across custom titles and first-message previews. */
+    search?: string;
+    /** `display` keeps pinned sessions first; `recent` ignores pin state. */
+    order?: 'display' | 'recent';
+}
+/** Result of a session-DB integrity check (used by `marifold doctor`). */
+export interface SessionDbHealth {
+    ok: boolean;
+    /** False when the DB file does not exist yet (fresh install — not an error). */
+    exists: boolean;
+    /** First integrity-check failures, or the open error, when not ok. */
+    error?: string;
+    sessions?: number;
+    turns?: number;
+}
+export interface SessionTruncateResult {
+    found: boolean;
+    removedTurns: number;
+}
+export interface SessionReplaceResult {
+    found: boolean;
+    replaced: boolean;
+}
+export interface ProfileActivitySummary {
+    profileName: string;
+    pinned?: boolean;
+    updatedAt?: string;
+    preview?: string;
+}
+export declare class SessionResolver {
+    private readonly sessionsDb;
+    private store?;
+    constructor(sessionsDb: string);
+    /** Open a connection with crash-resilience pragmas. `journal_mode = WAL` is a
+     * persistent file property — set by any connection it sticks and is inherited
+     * by every later opener (including priest's session store), making interrupted
+     * writes far less likely to corrupt the file. `synchronous` and `busy_timeout`
+     * are per-connection, so they are reapplied on every open. */
+    private open;
+    /** Read-only health check. Safe to run when the DB is corrupt (it is the whole
+     * point — `marifold doctor` must work when the app won't start), and never
+     * throws: failures are returned as `{ ok: false }`. Opens read/write like the
+     * app does, so a pass means the app can actually read the DB. */
+    checkIntegrity(): SessionDbHealth;
+    openStore(): SQLiteSessionStore;
+    list(limit?: number, profileName?: string, options?: SessionListOptions): SessionSummary[];
+    /** Contact-list metadata for every profile represented either by a session
+     * or a pinned display row. The latest session determines activity/preview. */
+    profileActivity(): ProfileActivitySummary[];
+    setProfilePinned(profileName: string, pinned: boolean): void;
+    deleteProfileDisplay(profileName: string): void;
+    latest(profileName?: string): SessionSummary | undefined;
+    get(sessionId: string): SessionDetail | undefined;
+    /** Read one persisted image without including its bytes in the session
+     * transcript payload. The service exposes this through an authenticated
+     * binary route so clients can fetch only visible/previewed images. */
+    getAttachment(sessionId: string, userTurnIndex: number, attachmentIndex: number): {
+        mediaType: string;
+        data?: string;
+        url?: string;
+    } | undefined;
+    delete(sessionId: string): boolean;
+    /** Update sidebar-only session fields without touching ids, turns, recency,
+     * or Priest's metadata column. A separate table prevents a model save that
+     * finishes later from overwriting a rename/pin made during the run. */
+    updateDisplay(sessionId: string, update: SessionDisplayUpdate): boolean;
+    /** Delete one user turn and the entire conversation branch after it. The
+     * ordinal is zero-based among user turns, so it remains stable even though
+     * Priest rewrites SQLite turn ids whenever a session is saved. */
+    truncateFromUserTurn(sessionId: string, userTurnIndex: number): SessionTruncateResult;
+    /** Return only the completed turns before a zero-based user-turn ordinal.
+     * Historical edits use this as model context so later exchanges cannot leak
+     * into the regenerated answer. `undefined` means the session/turn is absent. */
+    turnsBeforeUserTurn(sessionId: string, userTurnIndex: number): SessionTurnSummary[] | undefined;
+    /** Replace one persisted user→assistant exchange in place. Later exchanges
+     * keep their ids/order and therefore remain visible and available as future
+     * model context. Attachments are replaced only when `images` is provided. */
+    replaceExchange(sessionId: string, userTurnIndex: number, userText: string, assistantText: string, images?: ImageInput[], responseMetrics?: ResponseMetrics): SessionReplaceResult;
+    clear(options?: {
+        profileName?: string;
+        before?: string;
+        keepLast?: number;
+    }): {
+        count: number;
+        ids: string[];
+    };
+    replaceLastAssistantTurn(sessionId: string, content: string): boolean;
+    replaceLastUserTurn(sessionId: string, content: string): boolean;
+    /** Append one clean user→assistant exchange to a session (creating it if
+     * needed). Agent runs use this to record the objective + final answer as a
+     * single tidy pair, instead of priest's raw per-iteration `Objective:`/tool
+     * framing that made resumed transcripts confusing. */
+    appendExchange(sessionId: string, profileName: string, userText: string, assistantText: string, images?: ImageInput[], responseMetrics?: ResponseMetrics): Promise<void>;
+    /** Persist display-only image sources against the newest user turn. Priest
+     * intentionally stores text-only session history, so Marifold owns this
+     * side table and keeps it out of later model context. Local filesystem paths
+     * are deliberately skipped rather than exposed through the service API. */
+    saveLastUserTurnAttachments(sessionId: string, images?: ImageInput[]): void;
+    /** Persist content-free completion metadata against the newest user turn.
+     * Like attachments, the zero-based user-turn ordinal survives Priest's
+     * whole-session turn-row rewrites. */
+    saveLastResponseMetrics(sessionId: string, responseMetrics: ResponseMetrics): void;
+    rename(fromSessionId: string, toSessionId: string): boolean;
+    close(): void;
+    private listTurns;
+    private ensureAttachmentsTable;
+    private hasAttachmentsTable;
+    private listAttachments;
+    private replaceUserTurnAttachments;
+    private deleteAttachmentsForSession;
+    private ensureResponseMetricsTable;
+    private hasResponseMetricsTable;
+    private upsertResponseMetrics;
+    private listResponseMetrics;
+    private deleteResponseMetricsForSession;
+    private ensureSessionDisplayTable;
+    private ensureProfileDisplayTable;
+    private hasProfileDisplayTable;
+    private hasSessionDisplayTable;
+    private deleteDisplayForSession;
+    private storeError;
+}
+//# sourceMappingURL=SessionResolver.d.ts.map

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

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