@daniel156161/prism 0.2.81 → 0.2.83

package/dist/prism-extensions/integrations/ai-memory-errors.d.ts

@@ -12,5 +12,18 @@ export type AiMemoryRequestContext = {
     query?: string;
     filters?: Record<string, unknown>;
 };
+export type AiMemoryTransportContext = AiMemoryRequestContext & {
+    baseUrl: string;
+    timeoutMs: number;
+};
 export declare function formatApiFailure(status: number, text: string, context: AiMemoryRequestContext): string;
+/**
+ * A request that never reached the API (timeout, refused connection, DNS) must
+ * still explain itself. `fetch` alone only reports "fetch failed" or "The
+ * operation was aborted due to timeout", which is useless while debugging why a
+ * memory write did not land.
+ */
+export declare function formatTransportFailure(error: unknown, context: AiMemoryTransportContext): string;
+/** A 2xx response with a body that is not JSON, e.g. an HTML proxy page. */
+export declare function formatInvalidJsonFailure(error: unknown, text: string, context: AiMemoryTransportContext): string;
 export declare function formatDegradedNotice(degraded: any): string;

package/dist/prism-extensions/integrations/ai-memory-errors.js

@@ -41,6 +41,60 @@ export function formatApiFailure(status, text, context) {
         parts.push(`filters=${JSON.stringify(context.filters)}`);
     return parts.join(" | ");
 }
+function errorCode(error) {
+    const candidates = [error, error?.cause];
+    for (const candidate of candidates) {
+        const code = candidate?.code ?? candidate?.errno;
+        if (typeof code === "string" && code.trim())
+            return code.trim();
+    }
+    return undefined;
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        const cause = error.cause;
+        const causeMessage = cause instanceof Error ? cause.message : typeof cause === "string" ? cause : "";
+        return causeMessage && causeMessage !== error.message ? `${error.message}: ${causeMessage}` : error.message;
+    }
+    return String(error);
+}
+/**
+ * A request that never reached the API (timeout, refused connection, DNS) must
+ * still explain itself. `fetch` alone only reports "fetch failed" or "The
+ * operation was aborted due to timeout", which is useless while debugging why a
+ * memory write did not land.
+ */
+export function formatTransportFailure(error, context) {
+    const name = error?.name;
+    const code = errorCode(error);
+    const timedOut = name === "TimeoutError" || name === "AbortError";
+    const reason = timedOut
+        ? `request timed out after ${context.timeoutMs}ms`
+        : `request failed before a response arrived: ${errorMessage(error)}`;
+    const parts = [`AI Memory ${context.method} ${context.path} failed: ${reason}`];
+    if (code)
+        parts.push(`code=${code}`);
+    parts.push(`base_url=${context.baseUrl}`);
+    if (code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "EAI_AGAIN") {
+        parts.push(`hint=Is the AI Memory System API running and reachable at ${context.baseUrl}?`);
+    }
+    else if (timedOut) {
+        parts.push("hint=Raise PRISM_AI_MEMORY_TIMEOUT_MS or check the API load; nothing was confirmed as written.");
+    }
+    if (context.query)
+        parts.push(`query=${JSON.stringify(context.query)}`);
+    if (context.filters && Object.keys(context.filters).length > 0)
+        parts.push(`filters=${JSON.stringify(context.filters)}`);
+    return parts.join(" | ");
+}
+/** A 2xx response with a body that is not JSON, e.g. an HTML proxy page. */
+export function formatInvalidJsonFailure(error, text, context) {
+    const snippet = String(text ?? "").replace(/\s+/g, " ").trim().slice(0, 300);
+    const parts = [`AI Memory ${context.method} ${context.path} failed: response was not valid JSON: ${errorMessage(error)}`];
+    parts.push(`base_url=${context.baseUrl}`);
+    parts.push(`body=${snippet || "(empty)"}`);
+    return parts.join(" | ");
+}
 export function formatDegradedNotice(degraded) {
     const stages = Array.isArray(degraded?.stages) ? degraded.stages : [];
     if (stages.length === 0)

package/dist/prism-extensions/integrations/ai-memory-errors.js.map

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

package/dist/prism-extensions/integrations/ai-memory-http.d.ts

@@ -0,0 +1,29 @@
+/**
+ * HTTP transport for the AI Memory System integration.
+ *
+ * Every request funnels through `requestJson` so that transport failures
+ * (timeout, refused connection, unreadable or non-JSON body) end up as
+ * descriptive errors instead of a bare "fetch failed" / "The operation was
+ * aborted". The tool call is still reported as an error to the model, but the
+ * message now explains *why* it failed and which route/base URL was involved.
+ */
+export declare function configuredAiMemoryBaseUrl(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function aiMemoryBaseUrl(env?: NodeJS.ProcessEnv): string;
+export declare function aiMemoryRequestTimeoutMs(env?: NodeJS.ProcessEnv): number;
+export declare function aiMemoryStatusTimeoutMs(env?: NodeJS.ProcessEnv): number;
+export declare function aiMemoryInjectTimeoutMs(env?: NodeJS.ProcessEnv): number;
+export declare function aiMemoryInjectCacheTtlMs(env?: NodeJS.ProcessEnv): number;
+export type AiMemoryRequest = {
+    method: string;
+    path: string;
+    body?: unknown;
+    timeoutMs?: number;
+    query?: string;
+    filters?: Record<string, unknown>;
+};
+export declare function requestJson<T>(request: AiMemoryRequest): Promise<T>;
+export declare function postJson<T>(path: string, body: unknown, timeoutMs?: number): Promise<T>;
+export declare function putJson<T>(path: string, body: unknown, timeoutMs?: number): Promise<T>;
+export declare function deleteJson<T>(path: string, body: unknown, timeoutMs?: number): Promise<T>;
+export declare function methodJson<T>(method: string, path: string, timeoutMs?: number, body?: unknown): Promise<T>;
+export declare function getJson<T>(path: string, timeoutMs?: number): Promise<T>;

package/dist/prism-extensions/integrations/ai-memory-http.js

@@ -0,0 +1,102 @@
+/**
+ * HTTP transport for the AI Memory System integration.
+ *
+ * Every request funnels through `requestJson` so that transport failures
+ * (timeout, refused connection, unreadable or non-JSON body) end up as
+ * descriptive errors instead of a bare "fetch failed" / "The operation was
+ * aborted". The tool call is still reported as an error to the model, but the
+ * message now explains *why* it failed and which route/base URL was involved.
+ */
+import { readSettings } from "../core/shared-config.js";
+import { formatApiFailure, formatInvalidJsonFailure, formatTransportFailure } from "./ai-memory-errors.js";
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_STATUS_TIMEOUT_MS = 1_500;
+const DEFAULT_INJECT_TIMEOUT_MS = 1_200;
+const DEFAULT_INJECT_CACHE_TTL_MS = 60_000;
+export function configuredAiMemoryBaseUrl(env = process.env) {
+    const raw = env.PRISM_AI_MEMORY_BASE_URL ?? env.AI_MEMORY_BASE_URL ?? readSettings(undefined, env)?.aiMemory?.baseUrl ?? readSettings(undefined, env)?.aiMemoryBaseUrl;
+    if (typeof raw !== "string")
+        return undefined;
+    const trimmed = raw.trim().replace(/\/+$/, "");
+    return trimmed || undefined;
+}
+export function aiMemoryBaseUrl(env = process.env) {
+    const baseUrl = configuredAiMemoryBaseUrl(env);
+    if (!baseUrl)
+        throw new Error("AI Memory base URL is not configured. Set PRISM_AI_MEMORY_BASE_URL or aiMemory.baseUrl.");
+    return baseUrl;
+}
+function positiveIntegerSetting(value, fallback) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.max(1, Math.trunc(parsed));
+}
+export function aiMemoryRequestTimeoutMs(env = process.env) {
+    return positiveIntegerSetting(env.PRISM_AI_MEMORY_TIMEOUT_MS ?? env.PI_AI_MEMORY_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS);
+}
+export function aiMemoryStatusTimeoutMs(env = process.env) {
+    return positiveIntegerSetting(env.PRISM_AI_MEMORY_STATUS_TIMEOUT_MS ?? env.PI_AI_MEMORY_STATUS_TIMEOUT_MS, DEFAULT_STATUS_TIMEOUT_MS);
+}
+export function aiMemoryInjectTimeoutMs(env = process.env) {
+    return positiveIntegerSetting(env.PRISM_AI_MEMORY_INJECT_TIMEOUT_MS ?? env.PI_AI_MEMORY_INJECT_TIMEOUT_MS, DEFAULT_INJECT_TIMEOUT_MS);
+}
+export function aiMemoryInjectCacheTtlMs(env = process.env) {
+    return positiveIntegerSetting(env.PRISM_AI_MEMORY_INJECT_CACHE_TTL_MS ?? env.PI_AI_MEMORY_INJECT_CACHE_TTL_MS, DEFAULT_INJECT_CACHE_TTL_MS);
+}
+function requestContext(request) {
+    const payload = request.body;
+    return {
+        method: request.method,
+        path: request.path,
+        query: request.query ?? (typeof payload?.query === "string" ? payload.query : undefined),
+        filters: request.filters ?? payload?.filters,
+    };
+}
+export async function requestJson(request) {
+    const baseUrl = aiMemoryBaseUrl();
+    const timeoutMs = request.timeoutMs ?? aiMemoryRequestTimeoutMs();
+    const context = requestContext(request);
+    const transport = { ...context, baseUrl, timeoutMs };
+    let response;
+    let text;
+    try {
+        response = await fetch(`${baseUrl}${request.path}`, {
+            method: request.method,
+            headers: {
+                accept: "application/json",
+                ...(request.body === undefined ? {} : { "content-type": "application/json; charset=utf-8" }),
+            },
+            body: request.body === undefined ? undefined : JSON.stringify(request.body),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        text = await response.text();
+    }
+    catch (error) {
+        throw new Error(formatTransportFailure(error, transport));
+    }
+    if (!response.ok)
+        throw new Error(formatApiFailure(response.status, text, context));
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(formatInvalidJsonFailure(error, text, transport));
+    }
+}
+export function postJson(path, body, timeoutMs) {
+    return requestJson({ method: "POST", path, body, timeoutMs });
+}
+export function putJson(path, body, timeoutMs) {
+    return requestJson({ method: "PUT", path, body, timeoutMs });
+}
+export function deleteJson(path, body, timeoutMs) {
+    return requestJson({ method: "DELETE", path, body, timeoutMs });
+}
+export function methodJson(method, path, timeoutMs, body) {
+    return requestJson({ method, path, body, timeoutMs });
+}
+export function getJson(path, timeoutMs = aiMemoryStatusTimeoutMs()) {
+    return requestJson({ method: "GET", path, timeoutMs });
+}
+//# sourceMappingURL=ai-memory-http.js.map

package/dist/prism-extensions/integrations/ai-memory-http.js.map

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

package/dist/prism-extensions/integrations/ai-memory-system.d.ts

@@ -1,7 +1,10 @@
 type ExtensionAPI = any;
 import { type ThemeLike } from "../ui/tool-call-rendering.js";
+/** Test hook: drop injection caches and one-shot failure notices. */
+export declare function resetAiMemoryCaches(): void;
 export declare function shouldEnableAiMemory(env?: NodeJS.ProcessEnv): boolean;
 export declare function shouldInjectAiMemoryCandidates(env?: NodeJS.ProcessEnv): boolean;
+export declare function shouldInjectAiMemoryAlwaysContext(env?: NodeJS.ProcessEnv): boolean;
 export declare function formatSearchResponse(data: any): string;
 export declare function formatAiMemoryCandidate(row: any): string;
 export declare function buildAiMemoryContextMessage(results: any[]): any | undefined;

package/dist/prism-extensions/integrations/ai-memory-system.js

@@ -1,22 +1,24 @@
 import { Type } from "typebox";
 import { readSettings } from "../core/shared-config.js";
-import { formatApiFailure, formatDegradedNotice } from "./ai-memory-errors.js";
+import { formatDegradedNotice } from "./ai-memory-errors.js";
+import { aiMemoryBaseUrl, configuredAiMemoryBaseUrl, aiMemoryInjectCacheTtlMs, aiMemoryInjectTimeoutMs, aiMemoryRequestTimeoutMs, aiMemoryStatusTimeoutMs, deleteJson, getJson, methodJson, postJson, putJson, } from "./ai-memory-http.js";
+import { isAiMemoryWriteTool, renderAiMemoryWriteResult } from "./ai-memory-write-preview.js";
 import { renderCollapsibleTextResult } from "../ui/collapsed-text-rendering.js";
 import { obsidianOpenUrl } from "./obsidian-memory.js";
 import { ansiHyperlink, formatBracketedToolCall, renderSingleLineToolCall } from "../ui/tool-call-rendering.js";
-const DEFAULT_BASE_URL = "http://127.0.0.1:8765";
 const DEFAULT_LIMIT = 8;
 const DEFAULT_CONTEXT_LIMIT = 5;
 const DEFAULT_CONTEXT_SCORE_THRESHOLD = 0.15;
-const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
-const DEFAULT_STATUS_TIMEOUT_MS = 1_500;
-const DEFAULT_INJECT_TIMEOUT_MS = 1_200;
-const DEFAULT_INJECT_CACHE_TTL_MS = 60_000;
 const DEFAULT_ALWAYS_CONTEXT_CACHE_TTL_MS = 60_000;
 const injectCache = new Map();
 const alwaysContextCache = { expiresAt: 0, content: "" };
-function aiMemoryBaseUrl(env = process.env) {
-    return (env.PRISM_AI_MEMORY_BASE_URL || env.AI_MEMORY_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, "");
+const reportedBackgroundFailures = new Set();
+/** Test hook: drop injection caches and one-shot failure notices. */
+export function resetAiMemoryCaches() {
+    injectCache.clear();
+    alwaysContextCache.expiresAt = 0;
+    alwaysContextCache.content = "";
+    reportedBackgroundFailures.clear();
 }
 function clampLimit(value, fallback = DEFAULT_LIMIT) {
     const parsed = Number(value);
@@ -48,7 +50,7 @@ export function shouldEnableAiMemory(env = process.env) {
         return envValue;
     const settings = readSettings(undefined, env);
     const settingsValue = booleanSetting(settings?.aiMemory?.enabled ?? settings?.aiMemoryEnabled);
-    return settingsValue ?? true;
+    return settingsValue ?? configuredAiMemoryBaseUrl(env) !== undefined;
 }
 export function shouldInjectAiMemoryCandidates(env = process.env) {
     const envValue = booleanSetting(env.PRISM_AI_MEMORY_INJECT_CANDIDATES ?? env.PI_AI_MEMORY_INJECT_CANDIDATES);
@@ -56,7 +58,15 @@ export function shouldInjectAiMemoryCandidates(env = process.env) {
         return envValue;
     const settings = readSettings(undefined, env);
     const settingsValue = booleanSetting(settings?.aiMemory?.injectCandidates ?? settings?.aiMemoryInjectCandidates);
-    return settingsValue ?? true;
+    return settingsValue ?? configuredAiMemoryBaseUrl(env) !== undefined;
+}
+export function shouldInjectAiMemoryAlwaysContext(env = process.env) {
+    const envValue = booleanSetting(env.PRISM_AI_MEMORY_INJECT_ALWAYS_CONTEXT ?? env.PI_AI_MEMORY_INJECT_ALWAYS_CONTEXT);
+    if (envValue !== undefined)
+        return envValue;
+    const settings = readSettings(undefined, env);
+    const settingsValue = booleanSetting(settings?.aiMemory?.injectAlwaysContext ?? settings?.aiMemoryInjectAlwaysContext);
+    return settingsValue ?? configuredAiMemoryBaseUrl(env) !== undefined;
 }
 function aiMemoryContextLimit(env = process.env) {
     return clampLimit(env.PRISM_AI_MEMORY_CONTEXT_LIMIT ?? env.PI_AI_MEMORY_CONTEXT_LIMIT, DEFAULT_CONTEXT_LIMIT);
@@ -65,24 +75,6 @@ function aiMemoryContextScoreThreshold(env = process.env) {
     const parsed = Number(env.PRISM_AI_MEMORY_CONTEXT_SCORE_THRESHOLD ?? env.PI_AI_MEMORY_CONTEXT_SCORE_THRESHOLD);
     return Number.isFinite(parsed) ? Math.max(0, parsed) : DEFAULT_CONTEXT_SCORE_THRESHOLD;
 }
-function positiveIntegerSetting(value, fallback) {
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed))
-        return fallback;
-    return Math.max(1, Math.trunc(parsed));
-}
-function aiMemoryRequestTimeoutMs(env = process.env) {
-    return positiveIntegerSetting(env.PRISM_AI_MEMORY_TIMEOUT_MS ?? env.PI_AI_MEMORY_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS);
-}
-function aiMemoryStatusTimeoutMs(env = process.env) {
-    return positiveIntegerSetting(env.PRISM_AI_MEMORY_STATUS_TIMEOUT_MS ?? env.PI_AI_MEMORY_STATUS_TIMEOUT_MS, DEFAULT_STATUS_TIMEOUT_MS);
-}
-function aiMemoryInjectTimeoutMs(env = process.env) {
-    return positiveIntegerSetting(env.PRISM_AI_MEMORY_INJECT_TIMEOUT_MS ?? env.PI_AI_MEMORY_INJECT_TIMEOUT_MS, DEFAULT_INJECT_TIMEOUT_MS);
-}
-function aiMemoryInjectCacheTtlMs(env = process.env) {
-    return positiveIntegerSetting(env.PRISM_AI_MEMORY_INJECT_CACHE_TTL_MS ?? env.PI_AI_MEMORY_INJECT_CACHE_TTL_MS, DEFAULT_INJECT_CACHE_TTL_MS);
-}
 function cleanFilters(params) {
     const filters = {};
     for (const key of ["source", "project", "type", "status", "tag", "path"]) {
@@ -92,76 +84,6 @@ function cleanFilters(params) {
     }
     return filters;
 }
-async function postJson(path, body, timeoutMs = aiMemoryRequestTimeoutMs()) {
-    const baseUrl = aiMemoryBaseUrl();
-    const response = await fetch(`${baseUrl}${path}`, {
-        method: "POST",
-        headers: { "content-type": "application/json; charset=utf-8", accept: "application/json" },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    if (!response.ok) {
-        const payload = body;
-        throw new Error(formatApiFailure(response.status, text, {
-            method: "POST",
-            path,
-            query: typeof payload?.query === "string" ? payload.query : undefined,
-            filters: payload?.filters,
-        }));
-    }
-    return JSON.parse(text);
-}
-async function putJson(path, body, timeoutMs = aiMemoryRequestTimeoutMs()) {
-    const baseUrl = aiMemoryBaseUrl();
-    const response = await fetch(`${baseUrl}${path}`, {
-        method: "PUT",
-        headers: { "content-type": "application/json; charset=utf-8", accept: "application/json" },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    if (!response.ok)
-        throw new Error(formatApiFailure(response.status, text, { method: "PUT", path }));
-    return JSON.parse(text);
-}
-async function deleteJson(path, body, timeoutMs = aiMemoryRequestTimeoutMs()) {
-    const baseUrl = aiMemoryBaseUrl();
-    const response = await fetch(`${baseUrl}${path}`, {
-        method: "DELETE",
-        headers: { "content-type": "application/json; charset=utf-8", accept: "application/json" },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    if (!response.ok)
-        throw new Error(formatApiFailure(response.status, text, { method: "DELETE", path }));
-    return JSON.parse(text);
-}
-async function methodJson(method, path, timeoutMs = aiMemoryRequestTimeoutMs(), body) {
-    const baseUrl = aiMemoryBaseUrl();
-    const response = await fetch(`${baseUrl}${path}`, {
-        method,
-        headers: { accept: "application/json", ...(body === undefined ? {} : { "content-type": "application/json; charset=utf-8" }) },
-        body: body === undefined ? undefined : JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    if (!response.ok)
-        throw new Error(formatApiFailure(response.status, text, { method, path }));
-    return JSON.parse(text);
-}
-async function getJson(path, timeoutMs = aiMemoryStatusTimeoutMs()) {
-    const baseUrl = aiMemoryBaseUrl();
-    const response = await fetch(`${baseUrl}${path}`, {
-        headers: { accept: "application/json" },
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    if (!response.ok)
-        throw new Error(formatApiFailure(response.status, text, { method: "GET", path }));
-    return JSON.parse(text);
-}
 function formatSearchResults(results) {
     if (!Array.isArray(results) || results.length === 0)
         return "No AI Memory results found. Is the index built?";
@@ -271,12 +193,24 @@ export function formatAiMemoryToolCall(toolName, args, theme) {
     const label = toolName.replace(/^ai_memory_/, "ai memory ").replace(/_/g, " ");
     const rawValue = args?.query || args?.id || args?.path || args?.session || "";
     const value = typeof rawValue === "string" && rawValue.trim() ? rawValue.trim() : "...";
-    const linksToVaultNote = ["ai_memory_vault_write", "ai_memory_vault_edit", "ai_memory_vault_delete"].includes(toolName);
+    const linksToVaultNote = isAiMemoryWriteTool(toolName) || toolName === "ai_memory_vault_delete";
     if (linksToVaultNote && value !== "...") {
         return `${theme.fg("toolTitle", theme.bold(label))} ${theme.fg("accent", ansiHyperlink(obsidianOpenUrl(value), value))}`;
     }
     return formatBracketedToolCall(label, value, theme);
 }
+/**
+ * Surface background (non-tool) failures once per distinct reason. The dedupe key
+ * ignores the per-turn query so a broken API does not warn on every prompt.
+ */
+function reportBackgroundFailure(ctx, label, error) {
+    const message = `AI Memory ${label} failed: ${error instanceof Error ? error.message : String(error)}`;
+    const key = `${label}|${message.split(" | query=")[0]}`;
+    if (reportedBackgroundFailures.has(key))
+        return;
+    reportedBackgroundFailures.add(key);
+    ctx?.ui?.notify?.(message, "warning");
+}
 function formatVaultWriteResult(action, params, responsePath) {
     const path = String(responsePath ?? params.path ?? "");
     const frontmatter = params.frontmatter === undefined ? "" : String(params.frontmatter).trim();
@@ -535,8 +469,8 @@ export default function aiMemorySystemExtension(pi) {
         renderCall(args, theme, context) {
             return renderSingleLineToolCall(formatAiMemoryToolCall("ai_memory_vault_write", args, theme), context);
         },
-        renderResult(result, options, theme) {
-            return renderAiMemoryResult(result, options, theme);
+        renderResult(result, options, theme, context) {
+            return renderAiMemoryWriteResult("ai_memory_vault_write", result, options, theme, context);
         },
     });
     pi.registerTool({
@@ -562,8 +496,8 @@ export default function aiMemorySystemExtension(pi) {
         renderCall(args, theme, context) {
             return renderSingleLineToolCall(formatAiMemoryToolCall("ai_memory_vault_edit", args, theme), context);
         },
-        renderResult(result, options, theme) {
-            return renderAiMemoryResult(result, options, theme);
+        renderResult(result, options, theme, context) {
+            return renderAiMemoryWriteResult("ai_memory_vault_edit", result, options, theme, context);
         },
     });
     pi.registerTool({
@@ -606,39 +540,36 @@ export default function aiMemorySystemExtension(pi) {
             .then((active) => ctx.ui.setStatus?.("ai-memory", active === true ? "🧠 local" : undefined))
             .catch(() => ctx.ui.setStatus?.("ai-memory", undefined));
     });
-    pi.on?.("before_agent_start", async (event) => {
+    pi.on?.("before_agent_start", async (event, ctx) => {
+        const patch = {};
         // Always-loaded durable context (mapped from 00 Kontext) is injected as a
-        // system-prompt chunk so it remains in the cached prefix.
-        let alwaysBlock;
-        try {
-            const alwaysContent = await loadAlwaysContext();
-            const alwaysMessage = buildAlwaysContextMessage(alwaysContent);
-            alwaysBlock = alwaysMessage?.content;
-        }
-        catch {
-            // Ignore — always-context is best-effort.
-        }
-        const prev = String(event?.systemPrompt ?? "");
-        if (alwaysBlock && alwaysBlock.trim()) {
-            const block = alwaysBlock.trim();
-            return { systemPrompt: `${prev}${prev ? "\n\n" : ""}${block}` };
+        // system-prompt chunk so it remains in the cached prefix. It is opt-in so a
+        // missing local AI Memory daemon does not produce startup/per-turn warnings.
+        if (shouldInjectAiMemoryAlwaysContext()) {
+            try {
+                const alwaysBlock = buildAlwaysContextMessage(await loadAlwaysContext())?.content?.trim();
+                if (alwaysBlock) {
+                    const prev = String(event?.systemPrompt ?? "");
+                    patch.systemPrompt = `${prev}${prev ? "\n\n" : ""}${alwaysBlock}`;
+                }
+            }
+            catch (error) {
+                reportBackgroundFailure(ctx, "always-context injection", error);
+            }
         }
-        // Query-specific candidates
-        if (!shouldInjectAiMemoryCandidates())
-            return;
+        // Query-specific candidates (independent of the always-context block).
         const query = String(event?.prompt ?? "").trim();
-        if (!query)
-            return;
-        try {
-            const results = await loadAiMemoryInjectResults(query);
-            const message = buildAiMemoryContextMessage(results);
-            return message ? { message } : undefined;
-        }
-        catch {
-            // Candidate injection is opportunistic. The explicit ai_memory_search tool
-            // remains available and will surface API errors when the model calls it.
-            return undefined;
+        if (shouldInjectAiMemoryCandidates() && query) {
+            try {
+                const message = buildAiMemoryContextMessage(await loadAiMemoryInjectResults(query));
+                if (message)
+                    patch.message = message;
+            }
+            catch (error) {
+                reportBackgroundFailure(ctx, "candidate injection", error);
+            }
         }
+        return patch.systemPrompt === undefined && patch.message === undefined ? undefined : patch;
     });
 }
 //# sourceMappingURL=ai-memory-system.js.map