@circuitwall/jarela 2.3.0 → 2.5.0

package/.next/standalone/.next/server/chunks/9164.js

@@ -678,9 +678,10 @@ function isIntegrationProbe(name) {
 /* harmony export */ });
 /* unused harmony exports outlookSearchTool, outlookGetMessageTool, outlookListFoldersTool, outlookModifyMessageTool, outlookCreateDraftTool, outlookTrashMessageTool, outlookSendEmailTool */
 /* harmony import */ var _langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(49585);
-/* harmony import */ var zod__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(17033);
-/* harmony import */ var _lib_utils_html__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(85212);
-/* harmony import */ var _lib_utils_text__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(69494);
+/* harmony import */ var zod__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(17033);
+/* harmony import */ var _lib_utils_html__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(85212);
+/* harmony import */ var _lib_utils_text__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(69494);
+/* harmony import */ var _lib_utils_source_link__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(76385);
 /* harmony import */ var _packages_langchain_package__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(18932);
 /* harmony import */ var _lib_integrations_microsoft_oauth__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(46291);
 /**
@@ -700,6 +701,7 @@ function isIntegrationProbe(name) {
 
 
 
+
 // Exposed for the integrations test endpoint.
 function _resolveOutlookAuth() {
     return (0,_lib_integrations_microsoft_oauth__WEBPACK_IMPORTED_MODULE_2__/* .resolveMicrosoftAuth */ .jG)();
@@ -725,7 +727,8 @@ function summarizeMessage(m) {
         categories: m.categories ?? [],
         folder_id: m.parentFolderId ?? null,
         snippet: m.bodyPreview ?? null,
-        web_link: m.webLink ?? null
+        web_link: m.webLink ?? null,
+        cite_as: (0,_lib_utils_source_link__WEBPACK_IMPORTED_MODULE_3__/* .citeAs */ .w)(m.subject, m.webLink, "Outlook message")
     };
 }
 const BODY_CAP = 30000;
@@ -761,9 +764,9 @@ const outlookSearchTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/
 }, {
     name: "outlook_search",
     description: "Search the user's Outlook mailbox using KQL (Microsoft's keyword query language). " + "Returns message metadata (from, to, subject, received, snippet, labels) plus @odata.count " + "and next_link when available. Examples: " + "'from:notifications@github.com', 'subject:invoice hasAttachment:true', " + "'isRead:false received>=2026-05-17'. **Use this before calling outlook_get_message** — " + "the snippet is often enough.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        query: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().describe("KQL query string"),
-        max_results: zod__WEBPACK_IMPORTED_MODULE_3__/* .number */ .aig().int().optional().describe("Max messages (default 25, max 100)")
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        query: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().describe("KQL query string"),
+        max_results: zod__WEBPACK_IMPORTED_MODULE_4__/* .number */ .aig().int().optional().describe("Max messages (default 25, max 100)")
     })
 });
 const outlookGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ id })=>{
@@ -775,10 +778,10 @@ const outlookGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_
     if (m.error) return JSON.stringify(m);
     const summary = summarizeMessage(m);
     const rawBody = m.body?.content ?? "";
-    const plain = m.body?.contentType === "html" ? (0,_lib_utils_html__WEBPACK_IMPORTED_MODULE_4__/* .stripHtml */ .Q)(rawBody, {
+    const plain = m.body?.contentType === "html" ? (0,_lib_utils_html__WEBPACK_IMPORTED_MODULE_5__/* .stripHtml */ .Q)(rawBody, {
         preserveParagraphs: true
     }) : rawBody;
-    const { text: body, truncated } = (0,_lib_utils_text__WEBPACK_IMPORTED_MODULE_5__/* .truncateBytes */ .Q)(plain, BODY_CAP);
+    const { text: body, truncated } = (0,_lib_utils_text__WEBPACK_IMPORTED_MODULE_6__/* .truncateBytes */ .Q)(plain, BODY_CAP);
     return JSON.stringify({
         ...summary,
         body,
@@ -787,8 +790,8 @@ const outlookGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_
 }, {
     name: "outlook_get_message",
     description: "Fetch one Outlook message by id, including full headers and the decoded text body " + "(HTML stripped to plain text when needed). Body capped at 30KB with `truncated:true` " + "when cut off.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().describe("Outlook message id (from outlook_search results)")
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().describe("Outlook message id (from outlook_search results)")
     })
 });
 const outlookListFoldersTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ()=>{
@@ -814,7 +817,7 @@ const outlookListFoldersTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE
 }, {
     name: "outlook_list_folders",
     description: "List all Outlook mail folders. Use the `id` (or `well_known` name like 'inbox', " + "'drafts', 'sentitems', 'deleteditems', 'archive') with outlook_modify_message to move " + "a message between folders.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({})
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({})
 });
 const outlookModifyMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ id, mark_read, move_to_folder })=>{
     const auth = (0,_lib_integrations_microsoft_oauth__WEBPACK_IMPORTED_MODULE_2__/* .resolveMicrosoftAuth */ .jG)();
@@ -857,10 +860,10 @@ const outlookModifyMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODU
 }, {
     name: "outlook_modify_message",
     description: "Modify an Outlook message: mark read/unread and/or move to another folder. Use " + "`mark_read: true` to mark read, `mark_read: false` to mark unread. `move_to_folder` " + "accepts a folder id from outlook_list_folders or a well-known name (e.g. 'archive', " + "'deleteditems'). Note that moving returns a NEW message id because Graph clones the " + "item into the destination folder.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().describe("Outlook message id"),
-        mark_read: zod__WEBPACK_IMPORTED_MODULE_3__/* .boolean */ .zMY().optional().describe("Mark read (true) or unread (false)"),
-        move_to_folder: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().optional().describe("Destination folder id or well-known name")
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().describe("Outlook message id"),
+        mark_read: zod__WEBPACK_IMPORTED_MODULE_4__/* .boolean */ .zMY().optional().describe("Mark read (true) or unread (false)"),
+        move_to_folder: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().optional().describe("Destination folder id or well-known name")
     })
 });
 const outlookCreateDraftTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ to, cc, subject, body, content_type })=>{
@@ -899,12 +902,12 @@ const outlookCreateDraftTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE
 }, {
     name: "outlook_create_draft",
     description: "Create an Outlook draft email (saved to the Drafts folder, NOT sent). The user opens " + "Outlook to review and click Send. `to` and `cc` are arrays of plain email addresses. " + "`content_type` defaults to 'text'; pass 'html' if `body` contains HTML markup.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        to: zod__WEBPACK_IMPORTED_MODULE_3__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().email()).min(1).describe("Primary recipient emails"),
-        cc: zod__WEBPACK_IMPORTED_MODULE_3__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().email()).optional().describe("CC recipient emails"),
-        subject: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().optional().describe("Subject line"),
-        body: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().max(DRAFT_BODY_MAX_CHARS).optional().describe("Email body (max 100,000 characters)"),
-        content_type: zod__WEBPACK_IMPORTED_MODULE_3__/* ["enum"] */ .k5n([
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        to: zod__WEBPACK_IMPORTED_MODULE_4__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().email()).min(1).describe("Primary recipient emails"),
+        cc: zod__WEBPACK_IMPORTED_MODULE_4__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().email()).optional().describe("CC recipient emails"),
+        subject: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().optional().describe("Subject line"),
+        body: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().max(DRAFT_BODY_MAX_CHARS).optional().describe("Email body (max 100,000 characters)"),
+        content_type: zod__WEBPACK_IMPORTED_MODULE_4__/* ["enum"] */ .k5n([
             "text",
             "html"
         ]).optional().describe("Body content type (default 'text')")
@@ -933,8 +936,8 @@ const outlookTrashMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODUL
 }, {
     name: "outlook_trash_message",
     description: "Move an Outlook message to Deleted Items (recoverable from the trash for 30 days). " + "Does NOT permanently delete. Returns the new message id assigned after the move.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().describe("Outlook message id to trash")
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().describe("Outlook message id to trash")
     })
 });
 const outlookSendEmailTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ to, cc, bcc, subject, body, content_type, save_to_sent_items })=>{
@@ -982,17 +985,17 @@ const outlookSendEmailTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0
 }, {
     name: "outlook_send_email",
     description: "Send an Outlook email immediately via Microsoft Graph. Only use when the user explicitly asks " + "to send now; otherwise create a draft with outlook_create_draft. Supports text or HTML bodies " + "via `content_type`. If this returns a 403 scope error, ask the user to reconnect Outlook so " + "Mail.Send is granted.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_3__/* .object */ .Ikc({
-        to: zod__WEBPACK_IMPORTED_MODULE_3__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().email()).min(1).describe("Primary recipient emails"),
-        cc: zod__WEBPACK_IMPORTED_MODULE_3__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().email()).optional().describe("CC recipient emails"),
-        bcc: zod__WEBPACK_IMPORTED_MODULE_3__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().email()).optional().describe("BCC recipient emails"),
-        subject: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().optional().describe("Subject line"),
-        body: zod__WEBPACK_IMPORTED_MODULE_3__/* .string */ .YjP().max(SEND_BODY_MAX_CHARS).optional().describe("Email body (max 100,000 characters)"),
-        content_type: zod__WEBPACK_IMPORTED_MODULE_3__/* ["enum"] */ .k5n([
+    schema: zod__WEBPACK_IMPORTED_MODULE_4__/* .object */ .Ikc({
+        to: zod__WEBPACK_IMPORTED_MODULE_4__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().email()).min(1).describe("Primary recipient emails"),
+        cc: zod__WEBPACK_IMPORTED_MODULE_4__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().email()).optional().describe("CC recipient emails"),
+        bcc: zod__WEBPACK_IMPORTED_MODULE_4__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().email()).optional().describe("BCC recipient emails"),
+        subject: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().optional().describe("Subject line"),
+        body: zod__WEBPACK_IMPORTED_MODULE_4__/* .string */ .YjP().max(SEND_BODY_MAX_CHARS).optional().describe("Email body (max 100,000 characters)"),
+        content_type: zod__WEBPACK_IMPORTED_MODULE_4__/* ["enum"] */ .k5n([
             "text",
             "html"
         ]).optional().describe("Body content type (default 'text')"),
-        save_to_sent_items: zod__WEBPACK_IMPORTED_MODULE_3__/* .boolean */ .zMY().optional().describe("Whether Graph should save the message to Sent Items (default true)")
+        save_to_sent_items: zod__WEBPACK_IMPORTED_MODULE_4__/* .boolean */ .zMY().optional().describe("Whether Graph should save the message to Sent Items (default true)")
     })
 });
 (0,_packages_langchain_package__WEBPACK_IMPORTED_MODULE_1__/* .registerLangChainPackage */ .p)({
@@ -3832,12 +3835,13 @@ function drainQueuedBoundary(threadId) {
 function runBoundaryCompaction(threadId, boundarySeq, options) {
     const baseThread = (0,threads/* getThread */.fG)(threadId);
     const basePinSeq = baseThread?.hot_since_seq ?? null;
+    const baseLock = baseThread?.auto_boundary_locked_until_msg_count ?? 0;
     void (0,thread_compaction_state/* runTrackedCompaction */.PL)(threadId, "auto", boundarySeq, async (attempt)=>{
         await Promise.resolve();
-        await commitBoundaryCompaction(threadId, boundarySeq, basePinSeq, options, attempt);
+        await commitBoundaryCompaction(threadId, boundarySeq, basePinSeq, baseLock, options, attempt);
     }).catch((err)=>console.warn(`[context-boundary:auto] compaction failed thread=${threadId}: ${String(err)}`)).finally(()=>drainQueuedBoundary(threadId));
 }
-async function commitBoundaryCompaction(threadId, boundarySeq, basePinSeq, options, attempt) {
+async function commitBoundaryCompaction(threadId, boundarySeq, basePinSeq, baseLock, options, attempt) {
     const committed = await compactThreadWarmContext(threadId, boundarySeq, {
         expectedHotSinceSeq: basePinSeq,
         alignTopicBoundary: true,
@@ -3845,7 +3849,18 @@ async function commitBoundaryCompaction(threadId, boundarySeq, basePinSeq, optio
         ...options,
         attempt
     });
-    if (!committed) return;
+    if (!committed) {
+        // A pass that resolved to no change (the active topic still starts at the
+        // current pin) must not be retried on every following turn either. Skip
+        // it when the boundary or lock changed mid-pass (e.g. the user cleared or
+        // moved the boundary): that newer state wins over this stale pass.
+        const lockUntil = options.autoBoundaryLockedUntilMessageCount;
+        const current = (0,threads/* getThread */.fG)(threadId);
+        if (lockUntil !== undefined && current && (current.hot_since_seq ?? null) === basePinSeq && (current.auto_boundary_locked_until_msg_count ?? 0) === baseLock && lockUntil > baseLock) {
+            (0,threads/* setAutoBoundaryLock */.NU)(threadId, lockUntil);
+        }
+        return;
+    }
     console.info(`[context-boundary:auto] thread=${threadId} committed boundary_seq=${committed.boundarySeq} warm_msgs=${committed.sourceMessages}`);
 }
 async function findTopicBoundary(threadId, boundarySeq) {
@@ -7187,10 +7202,13 @@ function fuzzyUniqueRange(raw, oldString) {
     if (oldLines.some((line)=>line.length === 0)) return [];
     const rawLines = raw.split(/\r\n|\r|\n/);
     const rawLineStarts = [];
+    const eol = /\r\n|\r|\n/g;
     let offset = 0;
     for (const line of rawLines){
         rawLineStarts.push(offset);
-        offset += line.length + 1;
+        eol.lastIndex = offset + line.length;
+        const brk = eol.exec(raw);
+        offset = offset + line.length + (brk ? brk[0].length : 0);
     }
     const scores = [];
     for(let i = 0; i + oldLines.length <= rawLines.length; i++){
@@ -7247,7 +7265,9 @@ function findAllExact(haystack, needle) {
 function findWithTransforms(raw, oldString, fns) {
     const bufT = composeTransforms(raw, fns);
     const oldT = composeTransforms(oldString, fns);
-    if (oldT.text.length === 0) return [];
+    // A needle that normalizes to bare whitespace would match an arbitrary
+    // line break, so it can never identify an edit target.
+    if (oldT.text.trim().length === 0) return [];
     const starts = findAllExact(bufT.text, oldT.text);
     return starts.map((s)=>({
             start: bufT.toOriginal[s],
@@ -10698,6 +10718,8 @@ var pricing = __webpack_require__(95601);
 
 const CHARS_PER_TOKEN = 4;
 const DEFAULT_WINDOW_DAYS = 30;
+const METRICS_CACHE_MS = 5000;
+let metricsCache = null;
 function recalculateSnapshotCost(input, tables) {
     const rates = (0,pricing/* modelRatesFor */.En)(tables, input.provider, input.modelId);
     if (rates.inputPer1M == null && rates.outputPer1M == null) return input.recordedCostUsd;
@@ -10710,7 +10732,17 @@ async function getDashboardMetrics(days = DEFAULT_WINDOW_DAYS) {
     const now = new Date();
     const boundedDays = Number.isFinite(days) ? Math.min(120, Math.max(7, Math.floor(days))) : DEFAULT_WINDOW_DAYS;
     const since = new Date(now.getTime() - boundedDays * 24 * 60 * 60 * 1000).toISOString();
-    const usageRows = (0,lib_db/* getDb */.L)().prepare(`SELECT m.created_at, m.role, m.content, m.tool_events, m.thread_id, t.agent_id,
+    const db = (0,lib_db/* getDb */.L)();
+    const tables = (0,pricing/* getPricingTables */.iH)();
+    // total_changes covers this connection; data_version covers other writers.
+    const { changes } = db.prepare("SELECT total_changes() AS changes").get();
+    const { data_version: dataVersion } = db.prepare("PRAGMA data_version").get();
+    if (metricsCache?.db === db && metricsCache.changes === changes && metricsCache.dataVersion === dataVersion && metricsCache.tables === tables && metricsCache.metrics.days === boundedDays && metricsCache.metrics.generated_at.slice(0, 10) === now.toISOString().slice(0, 10) && now.getTime() - metricsCache.createdAt >= 0 && now.getTime() - metricsCache.createdAt < METRICS_CACHE_MS) {
+        return metricsCache.metrics;
+    }
+    const usageRows = db.prepare(`SELECT m.created_at, m.role,
+              CASE WHEN mu.input_tokens IS NULL THEN m.content ELSE '' END AS content,
+              m.tool_events, m.thread_id, t.agent_id,
               a.name AS agent_name, mc.provider AS provider,
               mc.model_id AS model_id,
                   COALESCE(ta.model_config_name, a.model_config_name, dmc.name) AS model_config_name,
@@ -10760,7 +10792,6 @@ async function getDashboardMetrics(days = DEFAULT_WINDOW_DAYS) {
             snapshotThreadIds.add(r.thread_id);
         }
     }
-    const tables = (0,pricing/* getPricingTables */.iH)();
     const { byProvider, generatedAt } = tables;
     const dayMap = seedDayBuckets(now, boundedDays);
     const agentMap = new Map();
@@ -11076,7 +11107,7 @@ async function getDashboardMetrics(days = DEFAULT_WINDOW_DAYS) {
             by_model: dayModels
         };
     }
-    return {
+    const metrics = {
         generated_at: now.toISOString(),
         days: boundedDays,
         summary: {
@@ -11132,6 +11163,15 @@ async function getDashboardMetrics(days = DEFAULT_WINDOW_DAYS) {
             notes: "Dashboard cost is recalculated from captured provider token usage and the latest matching rates. The original per-turn cost snapshots remain unchanged; legacy rows use content-length token estimates."
         }
     };
+    metricsCache = {
+        db,
+        changes,
+        dataVersion,
+        tables,
+        createdAt: now.getTime(),
+        metrics
+    };
+    return metrics;
 }
 function seedDayBuckets(now, days) {
     const out = new Map();
@@ -11675,6 +11715,7 @@ const PRICE_LINE_RE = new RegExp([
     String.raw`\$\s*\d+(?:\.\d+)?\s*(?:/|per)\s*(?:image|minute|request)`
 ].join("|"), "gi");
 const GOOGLE_RESULT_RE = /href="\/url\?q=([^"&]+)[^"]*"/gi;
+const GOOGLE_OWN_HOST_RE = /^(?:www|accounts|support|maps|policies|webcache)?\.?google\.[a-z.]+$/i;
 function toCanonicalProvider(id) {
     const lower = id.toLowerCase();
     if (lower.includes("google") || lower.includes("gemini")) return "google";
@@ -11706,7 +11747,8 @@ async function refreshPricingSnapshot(opts) {
     const existing = await readPricingSnapshot();
     if (!force && existing) {
         const ageDays = (Date.now() - Date.parse(existing.generated_at)) / (24 * 60 * 60 * 1000);
-        if (Number.isFinite(ageDays) && ageDays < ttlDays) {
+        // A future generated_at (clock skew, copied snapshot) must not pin the cache as fresh.
+        if (Number.isFinite(ageDays) && ageDays >= 0 && ageDays < ttlDays) {
             return {
                 refreshed: false,
                 reason: "fresh",
@@ -11843,6 +11885,8 @@ function parseGoogleResultLinks(html) {
     const out = [];
     const seen = new Set();
     let m;
+    // Shared /g regex: an early break leaves lastIndex mid-string for the next page.
+    GOOGLE_RESULT_RE.lastIndex = 0;
     while((m = GOOGLE_RESULT_RE.exec(html)) !== null){
         const raw = m[1] ?? "";
         let url = "";
@@ -11852,7 +11896,11 @@ function parseGoogleResultLinks(html) {
             continue;
         }
         if (!/^https?:\/\//i.test(url)) continue;
-        if (/\/google\./i.test(url)) continue;
+        try {
+            if (GOOGLE_OWN_HOST_RE.test(new URL(url).hostname)) continue;
+        } catch  {
+            continue;
+        }
         if (seen.has(url)) continue;
         seen.add(url);
         out.push(url);
@@ -13511,58 +13559,79 @@ function containsText(source, needle, ignoreCase) {
     if (!ignoreCase) return source.includes(needle);
     return source.toLowerCase().includes(needle.toLowerCase());
 }
-function dedupeLines(source, opts) {
-    const lines = source.split(/\r?\n/);
-    const keyed = lines.map((line)=>{
-        const normalized = opts.trim ? line.trim() : line;
-        return opts.ignoreCase ? normalized.toLowerCase() : normalized;
-    });
-    const keep = new Set();
-    const visit = opts.keep === "first" ? [
-        ...keyed.keys()
-    ] : [
-        ...keyed.keys()
+const FENCE_RE = /^\s{0,3}(`{3,}|~{3,})/;
+const HORIZONTAL_RULE_RE = /^\s{0,3}([-*_])(?:\s*\1){2,}\s*$/;
+/**
+ * Drop duplicate segments from `parts`, which alternates content (even
+ * indexes) and the original separator that follows it (odd indexes).
+ * Separators are preserved verbatim, so only removed segments change the
+ * text. `keyOf` returns null for a segment that must always be kept.
+ */ function dedupeSegments(parts, keyOf, keep) {
+    const contentIdx = parts.map((_, i)=>i).filter((i)=>i % 2 === 0);
+    const visit = keep === "first" ? contentIdx : [
+        ...contentIdx
     ].reverse();
     const seen = new Set();
+    const dropped = new Set();
     for (const idx of visit){
-        const key = keyed[idx];
-        if (opts.skipBlank && key.length === 0) {
-            keep.add(idx);
-            continue;
-        }
-        if (seen.has(key)) continue;
-        seen.add(key);
-        keep.add(idx);
+        const key = keyOf(idx);
+        if (key === null) continue;
+        if (seen.has(key)) dropped.add(idx);
+        else seen.add(key);
+    }
+    if (dropped.size === 0) return {
+        text: parts.join(""),
+        removed: 0
+    };
+    let text = "";
+    let emitted = false;
+    for (const idx of contentIdx){
+        if (dropped.has(idx)) continue;
+        if (emitted && idx > 0) text += parts[idx - 1];
+        text += parts[idx];
+        emitted = true;
     }
-    const next = lines.filter((_, idx)=>keep.has(idx));
     return {
-        text: next.join("\n"),
-        removed: lines.length - next.length
+        text,
+        removed: dropped.size
     };
 }
+function dedupeLines(source, opts) {
+    const parts = source.split(/(\r?\n)/);
+    // Fence markers, fenced code and horizontal rules repeat by design; a
+    // closing ``` is always a "duplicate" of the opening one.
+    const protectedIdx = new Set();
+    let fence = null;
+    for(let i = 0; i < parts.length; i += 2){
+        const marker = FENCE_RE.exec(parts[i])?.[1];
+        if (fence !== null) {
+            protectedIdx.add(i);
+            if (marker && marker[0] === fence[0] && marker.length >= fence.length && /^\s*[`~]+\s*$/.test(parts[i])) fence = null;
+        } else if (marker) {
+            protectedIdx.add(i);
+            fence = marker;
+        } else if (HORIZONTAL_RULE_RE.test(parts[i])) {
+            protectedIdx.add(i);
+        }
+    }
+    return dedupeSegments(parts, (i)=>{
+        if (protectedIdx.has(i)) return null;
+        const normalized = opts.trim ? parts[i].trim() : parts[i];
+        if (opts.skipBlank && normalized.length === 0) return null;
+        return opts.ignoreCase ? normalized.toLowerCase() : normalized;
+    }, opts.keep);
+}
 function dedupeParagraphs(source, opts) {
-    const paragraphs = source.split(/\n\s*\n/).map((p)=>p.trim()).filter((p)=>p.length > 0);
-    const keys = paragraphs.map((p)=>{
-        const base = opts.trim ? p.trim() : p;
+    const tail = /\s*$/.exec(source)?.[0] ?? "";
+    const parts = source.slice(0, source.length - tail.length).split(/(\r?\n(?:[ \t]*\r?\n)+)/);
+    const out = dedupeSegments(parts, (i)=>{
+        if (parts[i].trim().length === 0) return null;
+        const base = opts.trim ? parts[i].trim() : parts[i];
         return opts.ignoreCase ? base.toLowerCase() : base;
-    });
-    const keep = new Set();
-    const visit = opts.keep === "first" ? [
-        ...keys.keys()
-    ] : [
-        ...keys.keys()
-    ].reverse();
-    const seen = new Set();
-    for (const idx of visit){
-        const key = keys[idx];
-        if (seen.has(key)) continue;
-        seen.add(key);
-        keep.add(idx);
-    }
-    const next = paragraphs.filter((_, idx)=>keep.has(idx));
+    }, opts.keep);
     return {
-        text: next.join("\n\n"),
-        removed: paragraphs.length - next.length
+        text: out.text + tail,
+        removed: out.removed
     };
 }
 
@@ -14363,7 +14432,7 @@ function version_getCurrentVersion() {
 }
 
 ;// ./docs/adoption/changesets.json
-const changesets_namespaceObject = /*#__PURE__*/JSON.parse('{"schema_version":1,"changesets":[{"version":"2.0.1","previous_version":"2.0.0","date":"2026-10-11","hints":[],"commits":["chore(release): bump to 2.0.1","fix(npm): remove oversized runtime assets"],"prompts":[],"tools":[]},{"version":"2.0.2","previous_version":"2.0.1","date":"2026-10-11","hints":[],"commits":["chore(release): bump to 2.0.2","fix(npm): exclude nested server source maps"],"prompts":[],"tools":[]},{"version":"2.0.3","previous_version":"2.0.2","date":"2026-10-12","hints":[],"commits":["chore(release): bump to 2.0.3","fix(npm): remove maps before npm packing"],"prompts":[],"tools":[]},{"version":"2.0.4","previous_version":"2.0.3","date":"2026-10-12","hints":[],"commits":["chore(release): bump to 2.0.4","fix(npm): use installed onnx runtime dependencies"],"prompts":[],"tools":[]},{"version":"2.0.5","previous_version":"2.0.4","date":"2026-10-13","hints":[],"commits":["chore(release): bump to 2.0.5","fix(providers): detect streams that end without events","fix(http): fix gzip response decoding","docs(site): update guides, theme, and architecture diagrams","refactor(bridges): add capability-driven bridge modules","fix(security): update vulnerable media parser","refactor(modules): split built-in provider and package registries"],"prompts":[],"tools":[]},{"version":"2.1.0","previous_version":"2.0.5","date":"2026-10-14","hints":[],"commits":["chore(release): bump to 2.1.0","fix(release): add model download retries and cache","fix(chat): render grouped summary topic previews","fix(workflows): validate legacy checklist items","docs(pricing): document aggregator data sources","feat(core): add verified workflows, pricing signals, and summaries"],"prompts":[{"id":"static.agent.tool-usage-sop","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0},{"id":"system.Tool usage SOP","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0}],"tools":[{"name":"refresh_model_pricing","change":"changed","description_changed":true,"description":"Refresh provider pricing pages and separate OpenRouter/LiteLLM reference feeds, then recalculate dashboard estimates using provider-page rates only. Returns rate changes, source health, confidence, and current-versus-recorded dashboard totals. These are estimates, not invoice amounts.","previous_description":"Refresh the configured official LLM pricing sources and recalculate dashboard estimates using the latest rates. Returns rate changes, source health, confidence, and current-versus-recorded dashboard totals. These are estimates, not invoice amounts.","params_added":[],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"workflow_progress","change":"changed","description_changed":true,"description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. Every item needs input, expected output, and concrete va…","previous_description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only after verifying the action; use needs_attention for blockers; phase=complete requires every item done or skipped. The system-owned version_adoption workflow has its own durable …","params_added":["validation_evidence"],"params_removed":[],"params_changed":["items"],"required_added":[],"required_removed":[]}]},{"version":"2.2.0","previous_version":"2.1.0","date":"2026-10-15","hints":[],"commits":["chore(release): bump to 2.2.0","feat(embeddings): add on-demand local model download","fix(build): exclude foreign runtimes from standalone bundles"],"prompts":[],"tools":[]},{"version":"2.2.1","previous_version":"2.2.0","date":"2026-10-15","hints":[],"commits":["chore(release): bump to 2.2.1","fix(api): skip browser http cache for client requests","feat(models): add model enable toggle and atomic default","fix(github-copilot): remove retired pat route"],"prompts":[],"tools":[]},{"version":"2.3.0","previous_version":"2.2.1","date":"2026-10-16","hints":["If an agent\'s instructions or skills tell it to leave fact capture to compaction or to avoid `memory_upsert`, remove that guidance, since agents now save facts during the turn.","If a scheduled task or watcher prompt asks the agent to write memory facts, keep that in the agent\'s own turn; automation channel summaries no longer extract facts."],"commits":["chore(repo): remove dead exports and the unused deepseek package","fix(chat): restore thread activity and bound compaction per thread","fix(chat): render automation recaps in the warm summary card","fix(chat): restore the compacting state after switching agents","fix(chat): allow compacting bridge-only threads, report via toasts","fix(scripts): align make targets and install the current working tree","feat(agents): add topic pipeline to automation channel summaries","feat(agents): add validated topic pipeline for warm compaction","feat(agents): add proactive, validated memory saving for agents","fix(chat): group older summaries into collapsible topic rows","feat(agents): add auto-retry for failed workflow step contracts","feat(chat): add per-step retry to workflow checklists","feat(lifecycle): add release changesets for version adoption","fix(chat): keep boundary locate from snapping to bottom"],"prompts":[{"id":"static.agent.compaction-group","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-group-automation","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-topic-recap","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-topic-recap-automation","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.conversation-summary","source":"lib/agents/conversation-summary.ts","change":"changed","added_lines":["A topic groups every consecutive message about one subject and must","span at least two messages (a request and its reply); fold a stray","single message into the adjacent topic instead of giving it its own."],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.tool-usage-sop","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0},{"id":"system.Memory & recall","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["You have long-term memory across sessions, shared with every other Jarela agent. A record you save is available to other agents immediately. Background compaction also extracts facts later, but it runs late and can miss details, so it is a backstop, not your save step.","Proactive save procedure — run it whenever information fits the active memory policy, without waiting to be asked:","1. Trigger: the user states a preference, a fact about themselves or their work, a decision, a constraint, or a correction to something saved; or a tool result verifies a durable fact. Routine status, one-off chatter, secrets, credentials, and raw transcripts never qualify.","2. Check: memory_search (or memory_read for a known key) for an existing record on the same subject. Update that stable key rather than creating a duplicate or contradictory copy.","3. Write: call memory_upsert in the same turn, before your final reply, with namespace=\'facts\', a stable descriptive key, standalone content, concise tags, confidence=\'explicit\' for user-stated information (\'verified\' when tool-backed, \'inferred\' only when useful and reversible), observed_at when t…","4. Validate: the memory_upsert result must contain ok:true and the key you sent. If it failed, correct the arguments and retry once; if it still fails, tell the user it was not saved.","5. Cite: end your reply with one short line naming each saved key, for example \'Saved to memory: facts/answer-format-preference\'. Omit the line when nothing was saved."],"removed_lines":["You have long-term memory across sessions.","- Use memory_upsert proactively for structured records. Use namespace=\'facts\', concise tags, confidence=\'explicit\' for user-stated information, observed_at when the information was true, and expires_at for temporary facts. Keep memory_write only for legacy/free-form notes."],"omitted_lines":0},{"id":"system.Tool usage SOP","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0}],"tools":[{"name":"memory_upsert","change":"changed","description_changed":true,"description":"Store a durable, structured memory record for proactive semantic recall. Use namespace=\'facts\' for information that should surface in future conversations. Store explicit user preferences, verified facts, decisions, constraints, and reusable project context; do not store transient chat details or secrets. Use an expiry for temporary facts, and status=\'archived\' to soft-retire a record instead of deleting it. Save proactively in the same turn the information appears so other agents can use it immediately; do not defer to background compaction.","previous_description":"Store a durable, structured memory record for proactive semantic recall. Use namespace=\'facts\' for information that should surface in future conversations. Store explicit user preferences, verified facts, decisions, constraints, and reusable project context; do not store transient chat details or secrets. Use an expiry for temporary facts, and status=\'archived\' to soft-retire a record instead of deleting it.","params_added":[],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"workflow_progress","change":"changed","description_changed":true,"description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. A rejected update, or a step left checking or needs_atte…","previous_description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. Every item needs input, expected output, and concrete va…","params_added":["needs_user"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]}]}]}');
+const changesets_namespaceObject = /*#__PURE__*/JSON.parse('{"schema_version":1,"changesets":[{"version":"2.0.1","previous_version":"2.0.0","date":"2026-10-11","hints":[],"commits":["chore(release): bump to 2.0.1","fix(npm): remove oversized runtime assets"],"prompts":[],"tools":[]},{"version":"2.0.2","previous_version":"2.0.1","date":"2026-10-11","hints":[],"commits":["chore(release): bump to 2.0.2","fix(npm): exclude nested server source maps"],"prompts":[],"tools":[]},{"version":"2.0.3","previous_version":"2.0.2","date":"2026-10-12","hints":[],"commits":["chore(release): bump to 2.0.3","fix(npm): remove maps before npm packing"],"prompts":[],"tools":[]},{"version":"2.0.4","previous_version":"2.0.3","date":"2026-10-12","hints":[],"commits":["chore(release): bump to 2.0.4","fix(npm): use installed onnx runtime dependencies"],"prompts":[],"tools":[]},{"version":"2.0.5","previous_version":"2.0.4","date":"2026-10-13","hints":[],"commits":["chore(release): bump to 2.0.5","fix(providers): detect streams that end without events","fix(http): fix gzip response decoding","docs(site): update guides, theme, and architecture diagrams","refactor(bridges): add capability-driven bridge modules","fix(security): update vulnerable media parser","refactor(modules): split built-in provider and package registries"],"prompts":[],"tools":[]},{"version":"2.1.0","previous_version":"2.0.5","date":"2026-10-14","hints":[],"commits":["chore(release): bump to 2.1.0","fix(release): add model download retries and cache","fix(chat): render grouped summary topic previews","fix(workflows): validate legacy checklist items","docs(pricing): document aggregator data sources","feat(core): add verified workflows, pricing signals, and summaries"],"prompts":[{"id":"static.agent.tool-usage-sop","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0},{"id":"system.Tool usage SOP","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0}],"tools":[{"name":"refresh_model_pricing","change":"changed","description_changed":true,"description":"Refresh provider pricing pages and separate OpenRouter/LiteLLM reference feeds, then recalculate dashboard estimates using provider-page rates only. Returns rate changes, source health, confidence, and current-versus-recorded dashboard totals. These are estimates, not invoice amounts.","previous_description":"Refresh the configured official LLM pricing sources and recalculate dashboard estimates using the latest rates. Returns rate changes, source health, confidence, and current-versus-recorded dashboard totals. These are estimates, not invoice amounts.","params_added":[],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"workflow_progress","change":"changed","description_changed":true,"description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. Every item needs input, expected output, and concrete va…","previous_description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only after verifying the action; use needs_attention for blockers; phase=complete requires every item done or skipped. The system-owned version_adoption workflow has its own durable …","params_added":["validation_evidence"],"params_removed":[],"params_changed":["items"],"required_added":[],"required_removed":[]}]},{"version":"2.2.0","previous_version":"2.1.0","date":"2026-10-15","hints":[],"commits":["chore(release): bump to 2.2.0","feat(embeddings): add on-demand local model download","fix(build): exclude foreign runtimes from standalone bundles"],"prompts":[],"tools":[]},{"version":"2.2.1","previous_version":"2.2.0","date":"2026-10-15","hints":[],"commits":["chore(release): bump to 2.2.1","fix(api): skip browser http cache for client requests","feat(models): add model enable toggle and atomic default","fix(github-copilot): remove retired pat route"],"prompts":[],"tools":[]},{"version":"2.3.0","previous_version":"2.2.1","date":"2026-10-16","hints":["If an agent\'s instructions or skills tell it to leave fact capture to compaction or to avoid `memory_upsert`, remove that guidance, since agents now save facts during the turn.","If a scheduled task or watcher prompt asks the agent to write memory facts, keep that in the agent\'s own turn; automation channel summaries no longer extract facts."],"commits":["chore(repo): remove dead exports and the unused deepseek package","fix(chat): restore thread activity and bound compaction per thread","fix(chat): render automation recaps in the warm summary card","fix(chat): restore the compacting state after switching agents","fix(chat): allow compacting bridge-only threads, report via toasts","fix(scripts): align make targets and install the current working tree","feat(agents): add topic pipeline to automation channel summaries","feat(agents): add validated topic pipeline for warm compaction","feat(agents): add proactive, validated memory saving for agents","fix(chat): group older summaries into collapsible topic rows","feat(agents): add auto-retry for failed workflow step contracts","feat(chat): add per-step retry to workflow checklists","feat(lifecycle): add release changesets for version adoption","fix(chat): keep boundary locate from snapping to bottom"],"prompts":[{"id":"static.agent.compaction-group","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-group-automation","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-topic-recap","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.compaction-topic-recap-automation","source":"lib/agents/compaction-pipeline.ts","change":"added","added_lines":[],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.conversation-summary","source":"lib/agents/conversation-summary.ts","change":"changed","added_lines":["A topic groups every consecutive message about one subject and must","span at least two messages (a request and its reply); fold a stray","single message into the adjacent topic instead of giving it its own."],"removed_lines":[],"omitted_lines":0},{"id":"static.agent.tool-usage-sop","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0},{"id":"system.Memory & recall","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["You have long-term memory across sessions, shared with every other Jarela agent. A record you save is available to other agents immediately. Background compaction also extracts facts later, but it runs late and can miss details, so it is a backstop, not your save step.","Proactive save procedure — run it whenever information fits the active memory policy, without waiting to be asked:","1. Trigger: the user states a preference, a fact about themselves or their work, a decision, a constraint, or a correction to something saved; or a tool result verifies a durable fact. Routine status, one-off chatter, secrets, credentials, and raw transcripts never qualify.","2. Check: memory_search (or memory_read for a known key) for an existing record on the same subject. Update that stable key rather than creating a duplicate or contradictory copy.","3. Write: call memory_upsert in the same turn, before your final reply, with namespace=\'facts\', a stable descriptive key, standalone content, concise tags, confidence=\'explicit\' for user-stated information (\'verified\' when tool-backed, \'inferred\' only when useful and reversible), observed_at when t…","4. Validate: the memory_upsert result must contain ok:true and the key you sent. If it failed, correct the arguments and retry once; if it still fails, tell the user it was not saved.","5. Cite: end your reply with one short line naming each saved key, for example \'Saved to memory: facts/answer-format-preference\'. Omit the line when nothing was saved."],"removed_lines":["You have long-term memory across sessions.","- Use memory_upsert proactively for structured records. Use namespace=\'facts\', concise tags, confidence=\'explicit\' for user-stated information, observed_at when the information was true, and expires_at for temporary facts. Keep memory_write only for legacy/free-form notes."],"omitted_lines":0},{"id":"system.Tool usage SOP","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"removed_lines":["0. Classify the request. Informational answers may be direct; read/retrieve requests need a read tool; write/change requests need a state-changing tool; destructive requests also need the required confirmation. Use only these operation labels when describing work: read, write, execute, send, schedu…"],"omitted_lines":0}],"tools":[{"name":"memory_upsert","change":"changed","description_changed":true,"description":"Store a durable, structured memory record for proactive semantic recall. Use namespace=\'facts\' for information that should surface in future conversations. Store explicit user preferences, verified facts, decisions, constraints, and reusable project context; do not store transient chat details or secrets. Use an expiry for temporary facts, and status=\'archived\' to soft-retire a record instead of deleting it. Save proactively in the same turn the information appears so other agents can use it immediately; do not defer to background compaction.","previous_description":"Store a durable, structured memory record for proactive semantic recall. Use namespace=\'facts\' for information that should surface in future conversations. Store explicit user preferences, verified facts, decisions, constraints, and reusable project context; do not store transient chat details or secrets. Use an expiry for temporary facts, and status=\'archived\' to soft-retire a record instead of deleting it.","params_added":[],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"workflow_progress","change":"changed","description_changed":true,"description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. A rejected update, or a step left checking or needs_atte…","previous_description":"Report structured progress for a substantial multi-step task. Use only when the task has several dependent phases, likely spans turns, or needs explicit verification; skip simple tasks and work already covered by native tool progress. For agent-created workflows, send the full current items snapshot on every call and reuse the same workflow_id. Keep secrets and private data out of workflow fields. Mark items done only with observed validation evidence; use needs_attention for blockers; phase=complete requires every item done or skipped. Every item needs input, expected output, and concrete va…","params_added":["needs_user"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]}]},{"version":"2.4.0","previous_version":"2.3.0","date":"2026-10-16","hints":["If an agent\'s instructions or skills tell it not to include links or URLs in replies, decide whether it should now cite sources with the provided `cite_as` and chat links.","If you listed `localhost` or `127.0.0.1` in the proxy bypass list only to reach local services, you can remove them; loopback is always direct now."],"commits":["fix(core): keep proxy loopback direct, unicode fact keys, agent tuning","fix(agents): avoid repeated compaction from bridge rows and topic pins","fix(core): keep per-chat backlog, permalink refs and code fences","fix(core): fix edge cases in edits, paging, bridges and pricing","feat(integrations): add source permalinks to mail, calendar, chats"],"prompts":[{"id":"static.agent.tool-usage-sop","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["10. Link the source. When your reply refers to a specific email, calendar event, or chat that a tool result or bridge message gave you, link it: paste the item\'s cite_as value verbatim when present, otherwise use its web_link, html_link, or chat_link URL as a markdown link. Use only links you were …"],"removed_lines":[],"omitted_lines":0},{"id":"system.Delivery channel","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["WhatsApp does not render markdown links: write any link as the bare URL, even where a cite_as value is given."],"removed_lines":[],"omitted_lines":0},{"id":"system.Tool usage SOP","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["10. Link the source. When your reply refers to a specific email, calendar event, or chat that a tool result or bridge message gave you, link it: paste the item\'s cite_as value verbatim when present, otherwise use its web_link, html_link, or chat_link URL as a markdown link. Use only links you were …"],"removed_lines":[],"omitted_lines":0}],"tools":[]},{"version":"2.5.0","previous_version":"2.4.0","date":"2026-10-18","hints":[],"commits":["perf(chat): reuse startup reads when opening an agent","fix(chat): use available width and contain tool pill content","perf(db): use indexed reads and reuse chat history renders","fix(ui): align configuration panel widths","fix(packages): use workspace fallback for optional packages","feat(ui): add appearance presets and reorganize panels","fix(models): align live catalog capability metadata","fix(models): update provider model catalogs"],"prompts":[{"id":"system.Enabled tools","source":"lib/agents/prepare/system-prompt.ts","change":"changed","added_lines":["You can execute the 83 tool(s) listed below directly, plus 0 further permitted tool(s) through invoke_tool. 166 known tool(s) are not enabled for this agent; 0 known tool(s) are globally unavailable."],"removed_lines":["You can execute the 83 tool(s) listed below directly, plus 0 further permitted tool(s) through invoke_tool. 39 known tool(s) are not enabled for this agent; 0 known tool(s) are globally unavailable."],"omitted_lines":0}],"tools":[{"name":"confluence_add_comment","change":"added","description_changed":false,"description":"Add a footer comment to a Confluence page (v2). Pass exactly one of `body_text` or `body_storage`. Pass `parent_comment_id` (from confluence_get_comments) to reply in a thread.","params_added":["async_run","body_storage","body_text","deadline_ms","page_id","parent_comment_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_add_label","change":"added","description_changed":false,"description":"Add one or more labels to a Confluence page (additive — does not replace existing labels). Uses the v1 endpoint (v2 only reads labels as of 2026).","params_added":["async_run","deadline_ms","labels","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["labels","page_id"],"required_removed":[]},{"name":"confluence_create_page","change":"added","description_changed":false,"description":"Create a Confluence page (v2). Pass `space_key` (e.g. \'ENG\') — auto-resolved to v2 spaceId. Pass exactly one of `body_text` (plain text → storage XHTML automatically) or `body_storage` (raw XHTML for advanced edits). `parent_id` makes it a child page. Disable to make the agent unable to author Confluence pages.","params_added":["async_run","body_storage","body_text","deadline_ms","parent_id","space_key","stream","title"],"params_removed":[],"params_changed":[],"required_added":["space_key","title"],"required_removed":[]},{"name":"confluence_delete_attachment","change":"added","description_changed":false,"description":"Delete a Confluence attachment by id (v2). Default soft-deletes (trash, restorable). Pass purge=true for permanent deletion, which **also requires `confirm` to equal attachment_id** as a guardrail.","params_added":["async_run","attachment_id","confirm","deadline_ms","purge","stream"],"params_removed":[],"params_changed":[],"required_added":["attachment_id"],"required_removed":[]},{"name":"confluence_delete_comment","change":"added","description_changed":false,"description":"Permanently delete a Confluence comment (v2). Pass `kind: \'footer\' | \'inline\'`. **Destructive — no undo.** Disable to make the agent unable to delete comments.","params_added":["async_run","comment_id","deadline_ms","kind","stream"],"params_removed":[],"params_changed":[],"required_added":["comment_id","kind"],"required_removed":[]},{"name":"confluence_delete_page","change":"added","description_changed":false,"description":"Delete a Confluence page (v2). Default soft-deletes (page goes to trash, restorable). Pass purge=true for permanent deletion, which **also requires `confirm` to equal page_id** as a guardrail. Disable to make the agent unable to delete pages.","params_added":["async_run","confirm","deadline_ms","page_id","purge","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_get_attachment_content","change":"added","description_changed":false,"description":"Fetch an attachment\'s bytes by its download_link (from confluence_list_attachments). Returns UTF-8 text (capped at 50KB) for text-like content types, or base64 for binary. Override the auto-detection via `as_text`.","params_added":["as_text","async_run","deadline_ms","download_link","stream"],"params_removed":[],"params_changed":[],"required_added":["download_link"],"required_removed":[]},{"name":"confluence_get_comments","change":"added","description_changed":false,"description":"List footer comments (and inline comments by default) on a Confluence page. Returns id, version, author_id, created_at, body_storage, parent_comment_id (for threading). Tolerates the known v2 inline-comments 404 bug — surfaces it as `inline_warning` rather than failing.","params_added":["async_run","deadline_ms","include_inline","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_get_labels","change":"added","description_changed":false,"description":"List labels on a Confluence page (cursor-paginated). Default limit 50 (max 250).","params_added":["async_run","cursor","deadline_ms","limit","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_get_page","change":"added","description_changed":false,"description":"Fetch a Confluence page by id (v2). Returns title, space_id, parent_id, version, and BOTH body_storage (round-trippable into confluence_update_page) and body_view (rendered HTML, easier to summarize). Each body capped at 20KB.","params_added":["async_run","deadline_ms","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_get_page_ancestors","change":"added","description_changed":false,"description":"Return the parent chain (root → leaf) for a Confluence page. Useful for breadcrumbs and understanding where a page lives in the tree.","params_added":["async_run","deadline_ms","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_get_page_by_title","change":"added","description_changed":false,"description":"Find Confluence page(s) by exact title within a space. Auto-resolves `space_key` (e.g. \'ENG\') to the v2 space id. Returns up to 5 matches; pass `include_body: true` to also include storage XHTML.","params_added":["async_run","deadline_ms","include_body","space_key","stream","title"],"params_removed":[],"params_changed":[],"required_added":["space_key","title"],"required_removed":[]},{"name":"confluence_get_page_children","change":"added","description_changed":false,"description":"List direct children of a Confluence page (cursor-paginated). Pass `cursor` from a prior call\'s `next_cursor` to fetch the next page. Default limit 25 (max 250).","params_added":["async_run","cursor","deadline_ms","limit","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_list_attachments","change":"added","description_changed":false,"description":"List attachments on a Confluence page (cursor-paginated). Returns id, title, media_type, file_size, download_link. Use confluence_get_attachment_content with the download_link to fetch bytes.","params_added":["async_run","cursor","deadline_ms","limit","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_list_spaces","change":"added","description_changed":false,"description":"List Confluence spaces (cursor-paginated). Returns id, key, name, type, status, homepage_id. Useful for discovering space keys to pass to confluence_create_page or confluence_get_page_by_title.","params_added":["async_run","cursor","deadline_ms","limit","status","stream","type"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"confluence_move_page","change":"added","description_changed":false,"description":"Reorder/reparent a Confluence page (v2). `position`: \'before\' or \'after\' to place as a sibling of `target_id`; \'append\' to make it a child of `target_id`. Non-destructive.","params_added":["async_run","deadline_ms","page_id","position","stream","target_id"],"params_removed":[],"params_changed":[],"required_added":["page_id","position","target_id"],"required_removed":[]},{"name":"confluence_remove_label","change":"added","description_changed":false,"description":"Remove a single label from a Confluence page. Uses the v1 endpoint (v2 Label group is still read-only as of 2026). Counterpart to confluence_add_label.","params_added":["async_run","deadline_ms","label","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["label","page_id"],"required_removed":[]},{"name":"confluence_search","change":"added","description_changed":false,"description":"Search Confluence pages with CQL (Confluence Query Language). Examples: \'type=page AND title~\\"runbook\\"\', \'space=ENG AND lastmodified > now(\\"-7d\\")\'.","params_added":["async_run","cql","deadline_ms","max_results","stream"],"params_removed":[],"params_changed":[],"required_added":["cql"],"required_removed":[]},{"name":"confluence_update_comment","change":"added","description_changed":false,"description":"Edit an existing Confluence comment (v2). Pass `kind: \'footer\' | \'inline\'` to route to the correct endpoint. Same `body_text` xor `body_storage` pattern as confluence_add_comment. If version_number is omitted, the tool auto-fetches the current version and sends current+1 (Confluence requires strict +1 increments).","params_added":["async_run","body_storage","body_text","comment_id","deadline_ms","kind","stream","version_message","version_number"],"params_removed":[],"params_changed":[],"required_added":["comment_id","kind"],"required_removed":[]},{"name":"confluence_update_page","change":"added","description_changed":false,"description":"Update an existing Confluence page (v2). Pass exactly one of `body_text` or `body_storage`. If `version_number` is omitted, the tool auto-fetches the current version and sends current+1 (Confluence requires strict +1 increments; gaps cause 409). If `title` is omitted, the existing title is preserved. Avoid back-to-back updates within ~1 second — Confluence may return 409 even with the correct version. Disable to make the agent read-only on pages.","params_added":["async_run","body_storage","body_text","deadline_ms","page_id","stream","title","version_message","version_number"],"params_removed":[],"params_changed":[],"required_added":["page_id"],"required_removed":[]},{"name":"confluence_upload_attachment","change":"added","description_changed":false,"description":"Attach a file to a Confluence page. Pass content_base64 for binary or content_text for plain UTF-8. Uses the v1 multipart endpoint (v2 has no attachment-create endpoint as of 2026). Disable to make the agent unable to add attachments.","params_added":["async_run","comment","content_base64","content_text","deadline_ms","filename","minor_edit","page_id","stream"],"params_removed":[],"params_changed":[],"required_added":["filename","page_id"],"required_removed":[]},{"name":"github_add_comment","change":"added","description_changed":false,"description":"Post a comment on an issue or pull request (GitHub treats both the same). **PREFER THIS over shell-exec\'ing the `gh` CLI.** Body is rendered as GitHub-flavored Markdown.","params_added":["async_run","body","deadline_ms","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["body","number","owner","repo"],"required_removed":[]},{"name":"github_create_issue","change":"added","description_changed":false,"description":"Open a new issue in a repository. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Labels and assignees must already exist on the repo — invalid values produce a 422.","params_added":["assignees","async_run","body","deadline_ms","labels","owner","repo","stream","title"],"params_removed":[],"params_changed":[],"required_added":["owner","repo","title"],"required_removed":[]},{"name":"github_create_pull","change":"added","description_changed":false,"description":"Open a pull request. **PREFER THIS over shell-exec\'ing the `gh` CLI.** `head` is the branch with your changes (use `user:branch` for cross-fork PRs); `base` is the branch you want to merge into. Returns 422 if the head/base pair has no diff or if the branches don\'t exist.","params_added":["async_run","base","body","deadline_ms","draft","head","maintainer_can_modify","owner","repo","stream","title"],"params_removed":[],"params_changed":[],"required_added":["base","head","owner","repo","title"],"required_removed":[]},{"name":"github_create_review","change":"added","description_changed":false,"description":"Submit a pull-request review (approve / request changes / leave a comment). **PREFER THIS over shell-exec\'ing the `gh` CLI.** `event=APPROVE` doesn\'t require a body. `event=REQUEST_CHANGES` requires a body. Line-level inline review comments aren\'t supported by this tool yet — use the GitHub UI for those.","params_added":["async_run","body","commit_id","deadline_ms","event","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["event","number","owner","repo"],"required_removed":[]},{"name":"github_get_file","change":"added","description_changed":false,"description":"Read a file\'s contents from a repo at an optional ref (branch / tag / commit SHA). **PREFER THIS over shell-exec\'ing the `gh` CLI.** Returns up to 20 KB of UTF-8 text; longer files are truncated with `truncated: true`. Binary files return `binary: true` and `size_bytes` instead of `content`. GitHub itself rejects files larger than ~1 MB on this endpoint.","params_added":["async_run","deadline_ms","owner","path","ref","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["owner","path","repo"],"required_removed":[]},{"name":"github_get_issue","change":"added","description_changed":false,"description":"Fetch a single issue (or PR — same endpoint) by number. Returns body capped at 20KB, plus labels, assignees, and timestamps. **PREFER THIS over shell-exec\'ing the `gh` CLI.**","params_added":["async_run","deadline_ms","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_get_pull","change":"added","description_changed":false,"description":"Fetch detail on a single pull request — head/base SHAs, mergeable state, additions/deletions, changed files count, review comment count. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Note: `mergeable` may be null on a freshly-pushed PR; GitHub computes it asynchronously.","params_added":["async_run","deadline_ms","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_get_repo","change":"added","description_changed":false,"description":"Fetch repo summary (default branch, visibility, description, topics, star/fork counts, open-issue count). **PREFER THIS over shell-exec\'ing the `gh` CLI.** Useful before opening an issue (to confirm the repo exists / pick the right default branch).","params_added":["async_run","deadline_ms","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["owner","repo"],"required_removed":[]},{"name":"github_list_branches","change":"added","description_changed":false,"description":"List branches in a repository with their head SHAs and protection state. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Useful before opening a PR (confirm the head branch exists and is the SHA you expect).","params_added":["async_run","deadline_ms","max_results","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["owner","repo"],"required_removed":[]},{"name":"github_list_issue_comments","change":"added","description_changed":false,"description":"List comments on an issue or PR. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Each comment body is capped at 8 KB; `truncated: true` flags ones that hit the cap.","params_added":["async_run","deadline_ms","max_results","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_list_pull_files","change":"added","description_changed":false,"description":"List files changed in a pull request, with per-file additions/deletions and (capped) patch text. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Each patch caps at 8 KB; `patch_truncated: true` means the diff was longer than that. GitHub itself caps the response at 3000 files.","params_added":["async_run","deadline_ms","max_results","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_list_pull_reviews","change":"added","description_changed":false,"description":"List reviews submitted on a pull request (approvals, change-requests, comment-only). **PREFER THIS over shell-exec\'ing the `gh` CLI.** Use this to check whether a PR is approved before calling github_merge_pull.","params_added":["async_run","deadline_ms","max_results","number","owner","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_list_pulls","change":"added","description_changed":false,"description":"List pull requests for a repository, optionally filtered by state / head branch / base branch. **PREFER THIS over shell-exec\'ing the `gh` CLI.** For richer detail on a single PR (mergeable, review state, file count) call github_get_pull.","params_added":["async_run","base","deadline_ms","head","max_results","owner","repo","state","stream"],"params_removed":[],"params_changed":[],"required_added":["owner","repo"],"required_removed":[]},{"name":"github_merge_pull","change":"added","description_changed":false,"description":"Merge a pull request. **PREFER THIS over shell-exec\'ing the `gh` CLI.** `method` selects the merge strategy (default `merge`); pass `sha` to refuse the merge if the PR head has been force-pushed since you last looked. 405 means the PR isn\'t mergeable yet (still in CI / has conflicts / needs review); 409 means the `sha` guard tripped.","params_added":["async_run","commit_message","commit_title","deadline_ms","method","number","owner","repo","sha","stream"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_request_reviewers","change":"added","description_changed":false,"description":"Request review on a pull request from one or more users and/or teams. **PREFER THIS over shell-exec\'ing the `gh` CLI.** GitHub silently drops invalid usernames / team slugs — check the returned `requested_users` / `requested_teams` to see who actually got a notification.","params_added":["async_run","deadline_ms","number","owner","repo","reviewers","stream","team_reviewers"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_search_code","change":"added","description_changed":false,"description":"Search file contents across GitHub. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Pass `repo` (\\"owner/name\\") to scope to one repo; the tool prepends `repo:owner/name `. The `q` body accepts GitHub\'s full code-search syntax: \'language:ts symbolName\', \'extension:py path:tests assert\', etc. Each hit returns a 400-char snippet around the match. Note: GitHub code search has stricter rate limits than other endpoints (10/min for unauthenticated, 30/min for authenticated).","params_added":["async_run","deadline_ms","max_results","q","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["q"],"required_removed":[]},{"name":"github_search_issues","change":"added","description_changed":false,"description":"Search GitHub issues AND pull requests with the same query syntax as the github.com search bar. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Pass `repo` (\\"owner/name\\") to scope the search to a single repo — the tool prepends `repo:owner/name ` automatically. The `q` body accepts the full GitHub search vocabulary: \'is:issue is:open assignee:@me\', \'is:pr review-requested:@me\', \'label:bug created:>2026-01-01\', etc. `is_pr` in the response distinguishes PRs from issues.","params_added":["async_run","deadline_ms","max_results","q","repo","stream"],"params_removed":[],"params_changed":[],"required_added":["q"],"required_removed":[]},{"name":"github_update_issue","change":"added","description_changed":false,"description":"Edit an issue or PR (same endpoint): change title, body, labels, assignees, or close/reopen via `state`. **PREFER THIS over shell-exec\'ing the `gh` CLI.** Pass `state: \\"closed\\"` with `state_reason: \\"completed\\"` for done-as-intended, or `\\"not_planned\\"` for won\'t-fix.","params_added":["assignees","async_run","body","deadline_ms","labels","number","owner","repo","state","state_reason","stream","title"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"github_update_pull","change":"added","description_changed":false,"description":"Edit a pull request: title, body, base branch, or close/reopen. **PREFER THIS over shell-exec\'ing the `gh` CLI.** To MERGE a PR use github_merge_pull — `state` here only opens / closes.","params_added":["async_run","base","body","deadline_ms","maintainer_can_modify","number","owner","repo","state","stream","title"],"params_removed":[],"params_changed":[],"required_added":["number","owner","repo"],"required_removed":[]},{"name":"icloud_calendar_create_event","change":"added","description_changed":false,"description":"Create an event on an iCloud calendar. `start` and `end` are ISO timestamps; pass `all_day: true` and date-only strings (YYYY-MM-DD) for all-day events. Optional `rrule` sets recurrence specs (e.g. \'FREQ=WEEKLY;BYDAY=MO,FR\'). Optional `alerts` sets primary & secondary reminders (e.g. [\'15m\', \'1h\'] or [\'-PT15M\', \'-PT1H\']). Optional `travel_time` sets Apple travel duration (e.g. \'15m\', \'30m\').","params_added":["alerts","all_day","async_run","attendees","availability","calendar_url","deadline_ms","description","end","location","rrule","start","status","stream","summary","travel_time","url"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","end","start","summary"],"required_removed":[]},{"name":"icloud_calendar_delete_event","change":"added","description_changed":false,"description":"Delete an event by UID. For a recurring series this removes every occurrence; per-instance deletion (EXDATE) is not supported in this release.","params_added":["async_run","calendar_url","deadline_ms","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","uid"],"required_removed":[]},{"name":"icloud_calendar_get_event","change":"added","description_changed":false,"description":"Fetch a single event by UID, including the raw iCalendar source.","params_added":["async_run","calendar_url","deadline_ms","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","uid"],"required_removed":[]},{"name":"icloud_calendar_list_calendars","change":"added","description_changed":false,"description":"List iCloud event calendars (VEVENT collections). Returns the URL to pass to other calendar tools, plus a display name and color.","params_added":["async_run","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"icloud_calendar_list_events","change":"added","description_changed":false,"description":"List events in a calendar between two ISO timestamps. The calendar URL comes from `icloud_calendar_list_calendars`. Returns each event\'s uid, summary, start, end, location, description, and href.","params_added":["async_run","calendar_url","deadline_ms","stream","time_max","time_min"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","time_max","time_min"],"required_removed":[]},{"name":"icloud_calendar_update_event","change":"added","description_changed":false,"description":"Patch fields on an existing event. Only the supplied fields are overwritten — others are preserved. Pass `rrule` to update recurrence, `alerts` for primary/secondary alerts, or `travel_time` for Apple travel time. Pass \'NONE\' / empty array to remove recurrence, alerts, or travel time.","params_added":["alerts","async_run","availability","calendar_url","deadline_ms","description","end","location","rrule","start","status","stream","summary","travel_time","uid","url"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","uid"],"required_removed":[]},{"name":"icloud_mail_create_draft","change":"added","description_changed":false,"description":"Save a new draft to the iCloud Drafts folder. This intentionally does not send mail — iCloud SMTP is not wired in this release. The draft can be reviewed and sent from Apple Mail on the user\'s device.","params_added":["async_run","bcc","body_html","body_text","cc","deadline_ms","in_reply_to","stream","subject","to"],"params_removed":[],"params_changed":[],"required_added":["body_text","subject","to"],"required_removed":[]},{"name":"icloud_mail_delete_message","change":"added","description_changed":false,"description":"Move a message to the iCloud Trash (recoverable for ~30 days, then auto-purged by Apple). Resolves the localised Trash folder via the SPECIAL-USE `\\\\Trash` flag — works regardless of UI language. To permanently delete, the user must empty Trash from Mail.app or iCloud.com.","params_added":["async_run","deadline_ms","mailbox","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["mailbox","uid"],"required_removed":[]},{"name":"icloud_mail_flag_message","change":"added","description_changed":false,"description":"Add or remove standard IMAP flags on a message — typically `\\\\Seen` (read/unread) and `\\\\Flagged` (starred). Pass `seen=true` to mark read, `seen=false` to mark unread; same for `flagged`.","params_added":["async_run","deadline_ms","flagged","mailbox","seen","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["mailbox","uid"],"required_removed":[]},{"name":"icloud_mail_get_message","change":"added","description_changed":false,"description":"Fetch a single message by UID. Returns headers, plain-text body, and an attachments index. Set include_html=true to also pull the HTML alternative (skipped by default to keep responses small).","params_added":["async_run","deadline_ms","include_html","mailbox","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["uid"],"required_removed":[]},{"name":"icloud_mail_list_folders","change":"added","description_changed":false,"description":"List iCloud Mail folders (mailboxes) with message + unread counts. Use the SPECIAL-USE flag (`\\\\Drafts`, `\\\\Sent`, `\\\\Trash`, `\\\\Junk`, `\\\\Archive`) to identify well-known folders — iCloud localises the display names but the flags are stable.","params_added":["async_run","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"icloud_mail_list_messages","change":"added","description_changed":false,"description":"Search messages in an iCloud Mail folder. Returns the most recent results first. `query` does a body+subject substring search (IMAP SEARCH BODY semantics — iCloud does not implement Gmail-style operators). Date bounds are ISO strings (e.g. `2026-06-01`).","params_added":["async_run","before","deadline_ms","limit","mailbox","query","since","stream","unseen_only"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"icloud_mail_move_message","change":"added","description_changed":false,"description":"Move a message to a different folder. To send a message to trash, use `icloud_mail_delete_message` (it resolves the localised Trash folder via SPECIAL-USE).","params_added":["async_run","deadline_ms","from_mailbox","stream","to_mailbox","uid"],"params_removed":[],"params_changed":[],"required_added":["from_mailbox","to_mailbox","uid"],"required_removed":[]},{"name":"icloud_reminders_complete","change":"added","description_changed":false,"description":"Mark a reminder (VTODO) as completed.","params_added":["async_run","calendar_url","deadline_ms","stream","uid"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","uid"],"required_removed":[]},{"name":"icloud_reminders_create","change":"added","description_changed":false,"description":"Create a reminder (VTODO) in an iCloud Reminders list.","params_added":["async_run","calendar_url","deadline_ms","description","due","stream","summary"],"params_removed":[],"params_changed":[],"required_added":["calendar_url","summary"],"required_removed":[]},{"name":"icloud_reminders_list","change":"added","description_changed":false,"description":"List reminders (VTODO items) in a Reminders list. The calendar URL comes from a CalDAV collection whose components include `VTODO` — use `icloud_calendar_list_calendars` and filter on `components.includes(\'VTODO\')`, or call `icloud_reminders_list_lists`.","params_added":["async_run","calendar_url","deadline_ms","include_completed","stream"],"params_removed":[],"params_changed":[],"required_added":["calendar_url"],"required_removed":[]},{"name":"icloud_reminders_list_lists","change":"added","description_changed":false,"description":"List iCloud Reminders lists (VTODO calendar collections). Returns the URL to pass to the other reminders tools.","params_added":["async_run","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"jira_add_comment","change":"added","description_changed":false,"description":"Add a comment to a Jira issue. Plain text is auto-converted to ADF (Atlassian Document Format). **PREFER THIS over shell-exec\'ing the jira CLI.**","params_added":["async_run","body","deadline_ms","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["body","issue_key"],"required_removed":[]},{"name":"jira_add_remote_link","change":"added","description_changed":false,"description":"Attach a web/external link to a Jira issue (Confluence pages, GitHub PRs, dashboards, Slack threads, any URL). Distinct from jira_link_issues, which links one Jira issue to another. Pass `global_id` to make the link idempotent — re-posting with the same global_id updates the existing link rather than creating a duplicate. **PREFER THIS over pasting URLs into the description.**","params_added":["async_run","deadline_ms","global_id","icon_url","issue_key","stream","summary","title","url"],"params_removed":[],"params_changed":[],"required_added":["issue_key","title","url"],"required_removed":[]},{"name":"jira_add_worklog","change":"added","description_changed":false,"description":"Log time spent on a Jira issue. time_spent uses Jira\'s duration syntax: \'1h\', \'30m\', \'2d 4h\', etc. started is an ISO 8601 timestamp (defaults to now). comment is plain text auto-converted to ADF.","params_added":["async_run","comment","deadline_ms","issue_key","started","stream","time_spent"],"params_removed":[],"params_changed":[],"required_added":["issue_key","time_spent"],"required_removed":[]},{"name":"jira_align_add_comment","change":"added","description_changed":false,"description":"Post a comment on a Jira Align work item. **`type` is required** to route to the correct /<type>s/{id}/comments resource. Plain text body. Note: not all instances expose comments as a sub-resource on every type — check your Swagger if this 404s.","params_added":["async_run","body","deadline_ms","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["body","item_id","type"],"required_removed":[]},{"name":"jira_align_create_dependency","change":"added","description_changed":false,"description":"Link two Jira Align work items as a dependency: the predecessor must complete before the successor can. `dependency_type` defaults to the instance default (typically \'FS\' / finish-to-start) when omitted. Items can be of any type — JA dependencies cross the epic/feature/story hierarchy. **Disable this tool to make the agent read-only.** Note: dependency endpoint shape varies across JA versions — if this 4xx\'s, check your instance\'s Swagger.","params_added":["async_run","deadline_ms","dependency_type","description","predecessor_id","stream","successor_id"],"params_removed":[],"params_changed":[],"required_added":["predecessor_id","successor_id"],"required_removed":[]},{"name":"jira_align_create_entity","change":"added","description_changed":false,"description":"Create a Jira Align hierarchy entity: program, team, release, sprint (PI), portfolio, or value stream. Use to spin up a new program/team or schedule a new sprint. Optional dates must be ISO-8601 (e.g. \'2026-07-01\'). **Disable this tool to make the agent read-only.**","params_added":["async_run","deadline_ms","description","end_date","entity_type","name","parent_id","portfolio_id","program_id","start_date","stream"],"params_removed":[],"params_changed":[],"required_added":["entity_type","name"],"required_removed":[]},{"name":"jira_align_create_item","change":"added","description_changed":false,"description":"Create a Jira Align work item in a given type\'s collection. Set `type` to one of epic|capability|feature|story|theme|task|defect|objective. Pass `parent_id` to attach to an existing hierarchy. **Disable this tool to make the agent read-only.**","params_added":["async_run","deadline_ms","description","owner","parent_id","program_id","stream","team_id","title","type"],"params_removed":[],"params_changed":[],"required_added":["title","type"],"required_removed":[]},{"name":"jira_align_delete_comment","change":"added","description_changed":false,"description":"Permanently delete a comment from a Jira Align work item. **Irreversible.** **`type` is required.** The agent must also pass `confirm` set to the same `comment_id` — a deliberate two-arg gate so a mis-issued tool call can\'t wipe a comment. **Leave this tool disabled unless the user explicitly wants delete capability.**","params_added":["async_run","comment_id","confirm","deadline_ms","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["comment_id","confirm","item_id","type"],"required_removed":[]},{"name":"jira_align_delete_dependency","change":"added","description_changed":false,"description":"Permanently remove a Jira Align dependency link. **Irreversible.** Use jira_align_list_dependencies first to find the dependency_id. The agent must pass `confirm` equal to `dependency_id` — a two-arg gate against accidental deletes. **Leave this tool disabled unless the user explicitly wants delete capability.**","params_added":["async_run","confirm","deadline_ms","dependency_id","stream"],"params_removed":[],"params_changed":[],"required_added":["confirm","dependency_id"],"required_removed":[]},{"name":"jira_align_delete_entity","change":"added","description_changed":false,"description":"Permanently delete a Jira Align hierarchy entity (program/team/release/sprint/portfolio/value stream). **Irreversible** and may cascade — deleting a program can affect every work item scoped to it. The agent must pass `confirm` equal to `entity_id` — a two-arg gate against accidental deletes. **Leave this tool disabled unless the user explicitly wants delete capability.**","params_added":["async_run","confirm","deadline_ms","entity_id","entity_type","stream"],"params_removed":[],"params_changed":[],"required_added":["confirm","entity_id","entity_type"],"required_removed":[]},{"name":"jira_align_delete_item","change":"added","description_changed":false,"description":"Permanently delete a Jira Align work item. **Irreversible.** **`type` is required** to route to the correct collection. The agent must also pass `confirm` set to the same `item_id` — a deliberate two-arg gate so a mis-issued tool call can\'t wipe an item. **Leave this tool disabled unless the user explicitly wants delete capability.**","params_added":["async_run","confirm","deadline_ms","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["confirm","item_id","type"],"required_removed":[]},{"name":"jira_align_get_entity","change":"added","description_changed":false,"description":"Fetch a single Jira Align hierarchy entity by id: program, team, release, sprint (PI), portfolio, or value stream. Returns id, name, description, state, hierarchy refs, dates.","params_added":["async_run","deadline_ms","entity_id","entity_type","stream"],"params_removed":[],"params_changed":[],"required_added":["entity_id","entity_type"],"required_removed":[]},{"name":"jira_align_get_item","change":"added","description_changed":false,"description":"Fetch a Jira Align work item by id. **Must specify `type`** — Jira Align v2 has no generic /items endpoint, so the type tells us which collection to hit (epic|capability|feature|story|theme|task|defect|objective). Returns title, state, hierarchy refs (parent/program/team/release/sprint), owner, and timestamps. Use jira_align_list_children to walk the tree.","params_added":["async_run","deadline_ms","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["item_id","type"],"required_removed":[]},{"name":"jira_align_list_children","change":"added","description_changed":false,"description":"List the direct children of a Jira Align work item. **Both `parent_id` and `child_type` are required** — the API has no generic `/items/{id}/children` route, so we query the child collection with a parentId filter. Use the standard hierarchy: theme → epic → capability → feature → story (instances may differ; check your portfolio config). For deeper trees, call this once per level.","params_added":["async_run","child_type","deadline_ms","max_results","parent_id","stream"],"params_removed":[],"params_changed":[],"required_added":["child_type","parent_id"],"required_removed":[]},{"name":"jira_align_list_comments","change":"added","description_changed":false,"description":"List comments on a Jira Align work item. **`type` is required** to route to the correct /<type>s/{id}/comments resource. Returns id, body, author, and timestamps. Call this to discover a comment_id before jira_align_update_comment / jira_align_delete_comment.","params_added":["async_run","deadline_ms","item_id","max_results","stream","type"],"params_removed":[],"params_changed":[],"required_added":["item_id","type"],"required_removed":[]},{"name":"jira_align_list_dependencies","change":"added","description_changed":false,"description":"List Jira Align dependencies (links between work items) involving a given item. By default returns both inbound and outbound; pass direction=\'predecessor\' for items the given item depends on (blockers), or direction=\'successor\' for items that depend on the given item (dependents). Returns id, predecessor_id, successor_id, dependency_type, state. Use this to find a dependency_id before calling jira_align_delete_dependency.","params_added":["async_run","deadline_ms","direction","item_id","max_results","stream"],"params_removed":[],"params_changed":[],"required_added":["item_id"],"required_removed":[]},{"name":"jira_align_list_entities","change":"added","description_changed":false,"description":"List non-work-item Jira Align entities of a given type: programs, teams, releases, sprints (PIs), portfolios, or value streams. Use to resolve human names → ids before passing to work-item tools, or to enumerate available programs/teams when planning work. Filter by `name_filter` (contains-match) or by raw OData `filter` for advanced cases.","params_added":["async_run","deadline_ms","entity_type","filter","max_results","name_filter","stream"],"params_removed":[],"params_changed":[],"required_added":["entity_type"],"required_removed":[]},{"name":"jira_align_search_items","change":"added","description_changed":false,"description":"Search Jira Align work items of a given type, with optional state/owner/program/team filters. **`type` is required** — JA v2 has no cross-type item collection, so each search hits one /<type>s endpoint. Use `filter` to pass an OData expression for fields this tool doesn\'t model (e.g. custom fields). Returns a compact list (id, title, state, owner). Pass updated_since=\'-7d\' or an ISO date for recency.","params_added":["async_run","deadline_ms","filter","max_results","owner","program_id","state","stream","team_id","type","updated_since"],"params_removed":[],"params_changed":[],"required_added":["type"],"required_removed":[]},{"name":"jira_align_transition_item","change":"added","description_changed":false,"description":"Move a Jira Align work item to a new workflow state (e.g. \'In Progress\' → \'Done\'). Call without `state` to list valid transitions for the item\'s type. **`type` is required.**","params_added":["async_run","deadline_ms","item_id","state","stream","type"],"params_removed":[],"params_changed":[],"required_added":["item_id","type"],"required_removed":[]},{"name":"jira_align_update_comment","change":"added","description_changed":false,"description":"Edit the body of an existing comment on a Jira Align work item. **`type` is required** to route to /<type>s/{item_id}/comments/{comment_id}. Use jira_align_list_comments first to find the comment_id. **Disable this tool to make the agent read-only.**","params_added":["async_run","body","comment_id","deadline_ms","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["body","comment_id","item_id","type"],"required_removed":[]},{"name":"jira_align_update_entity","change":"added","description_changed":false,"description":"Patch fields on a Jira Align hierarchy entity (program/team/release/sprint/portfolio/value stream). Only the listed fields are touched. Use camelCase JA REST field names (name, description, parentId, startDate, endDate, isActive, …). **Disable this tool to make the agent read-only.**","params_added":["async_run","deadline_ms","entity_id","entity_type","fields","stream"],"params_removed":[],"params_changed":[],"required_added":["entity_id","entity_type","fields"],"required_removed":[]},{"name":"jira_align_update_item","change":"added","description_changed":false,"description":"Patch fields on a Jira Align item (title, description, owner, programId, teamId, parentId, custom fields, …). Only the listed fields are touched. **`type` is required** to route the PATCH to the correct /<type>s/{id} resource. **Disable this tool to make the agent read-only.**","params_added":["async_run","deadline_ms","fields","item_id","stream","type"],"params_removed":[],"params_changed":[],"required_added":["fields","item_id","type"],"required_removed":[]},{"name":"jira_create_component","change":"added","description_changed":false,"description":"Create a component on a Jira project. assignee_type controls default assignee for issues with this component: \'PROJECT_DEFAULT\' | \'COMPONENT_LEAD\' | \'PROJECT_LEAD\' | \'UNASSIGNED\'.","params_added":["assignee_type","async_run","deadline_ms","description","lead_account_id","name","project_key","stream"],"params_removed":[],"params_changed":[],"required_added":["name","project_key"],"required_removed":[]},{"name":"jira_create_issue","change":"added","description_changed":false,"description":"Create a new Jira issue. Defaults to issue_type=\'Task\'. Pass parent_key to create a sub-task or attach a Story to an Epic. Custom fields accept display names or customfield_NNNNN ids. **PREFER THIS over shell-exec\'ing the jira CLI.**","params_added":["assignee_account_id","async_run","custom_fields","deadline_ms","description","issue_type","labels","parent_key","project_key","stream","summary"],"params_removed":[],"params_changed":[],"required_added":["project_key","summary"],"required_removed":[]},{"name":"jira_create_issues_bulk","change":"added","description_changed":false,"description":"Create up to 50 Jira issues in a single API call. Each entry takes the same shape as jira_create_issue (project_key, summary, description, issue_type, parent_key, labels, assignee_account_id, custom_fields). Returns per-issue keys plus any partial errors. **PREFER THIS over many sequential jira_create_issue calls** when creating ≥3 tickets.","params_added":["async_run","deadline_ms","issues","stream"],"params_removed":[],"params_changed":[],"required_added":["issues"],"required_removed":[]},{"name":"jira_create_sprint","change":"added","description_changed":false,"description":"Create a future sprint on a board. New sprints always start in \'future\' state — use jira_update_sprint with state=\'active\' to start it. start_date/end_date are ISO 8601 strings; they\'re optional but required by Atlassian before you can start the sprint.","params_added":["async_run","board_id","deadline_ms","end_date","goal","name","start_date","stream"],"params_removed":[],"params_changed":[],"required_added":["board_id","name"],"required_removed":[]},{"name":"jira_create_version","change":"added","description_changed":false,"description":"Create a new version on a Jira project. Pass the project key — we resolve it to the numeric id. start_date / release_date are \'YYYY-MM-DD\'. Set released=true to mark released on creation.","params_added":["async_run","deadline_ms","description","name","project_key","release_date","released","start_date","stream"],"params_removed":[],"params_changed":[],"required_added":["name","project_key"],"required_removed":[]},{"name":"jira_delete_attachment","change":"added","description_changed":false,"description":"Permanently delete an attachment from a Jira issue by id. **Destructive — no undo.** Look up the id via jira_get_issue.attachments[].id. Disable to make the agent unable to delete attachments.","params_added":["async_run","attachment_id","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":["attachment_id"],"required_removed":[]},{"name":"jira_delete_comment","change":"added","description_changed":false,"description":"Permanently delete a comment from a Jira issue. **Destructive — no undo.** Look up the id via jira_get_issue (include_comments: true) or jira_get_comments. Disable to make the agent unable to delete comments.","params_added":["async_run","comment_id","deadline_ms","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["comment_id","issue_key"],"required_removed":[]},{"name":"jira_delete_issue","change":"added","description_changed":false,"description":"Permanently delete a Jira issue. **DESTRUCTIVE — there is no undo from the API.** By default, Jira refuses to delete an issue that has sub-tasks; pass delete_subtasks=true to delete them too. Disable this tool entirely to make the agent unable to delete tickets.","params_added":["async_run","deadline_ms","delete_subtasks","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_delete_link","change":"added","description_changed":false,"description":"Delete an issue link (Jira-to-Jira, default) or a remote/web link. Look up the id first with jira_get_issue (issue_links[].id or remote_links[].id — pass `expand: [\'remoteLinks\']` for the latter). For remote links, also pass the issue key as `link_type` since the API is scoped per-issue.","params_added":["async_run","deadline_ms","kind","link_id","link_type","stream"],"params_removed":[],"params_changed":[],"required_added":["link_id"],"required_removed":[]},{"name":"jira_delete_sprint","change":"added","description_changed":false,"description":"Permanently delete a sprint. **Irreversible** — issues are unassigned from the sprint but the sprint\'s velocity/burndown data is lost. The agent must pass `confirm` set to the same `sprint_id` to proceed (two-arg gate). **Leave this tool disabled unless the user explicitly wants delete capability.**","params_added":["async_run","confirm","deadline_ms","sprint_id","stream"],"params_removed":[],"params_changed":[],"required_added":["confirm","sprint_id"],"required_removed":[]},{"name":"jira_find_user","change":"added","description_changed":false,"description":"Look up Jira Cloud users by email or display-name fragment. Returns accountId values you can pass to jira_update_issue\'s assignee_account_id. Use when you only have an email.","params_added":["async_run","deadline_ms","query","stream"],"params_removed":[],"params_changed":[],"required_added":["query"],"required_removed":[]},{"name":"jira_get_attachment_content","change":"added","description_changed":false,"description":"Fetch a Jira issue attachment\'s bytes by content_url (from jira_get_issue.attachments[].content_url). Returns UTF-8 text capped at 50KB for text-like content types, or base64 for binary. Override the auto-detection via `as_text`. Mirrors confluence_get_attachment_content.","params_added":["as_text","async_run","content_url","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":["content_url"],"required_removed":[]},{"name":"jira_get_board","change":"added","description_changed":false,"description":"Fetch board metadata and configuration in one call: id, name, type, project_key, plus filter id, sub-query JQL, estimation field, and ranking custom field. Use this when you need to know how issues are estimated or ranked on a specific board.","params_added":["async_run","board_id","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":["board_id"],"required_removed":[]},{"name":"jira_get_changelog","change":"added","description_changed":false,"description":"Fetch a Jira issue\'s history (paginated). Each entry has author, timestamp, and a list of field-level changes (field name, from, to). Useful for \'what changed yesterday?\' audits and for surfacing the previous value of a field.","params_added":["async_run","deadline_ms","issue_key","max_results","start_at","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_get_comments","change":"added","description_changed":false,"description":"Paginated comment list for a Jira issue. Use this when an issue has more comments than the embedded list returned by jira_get_issue (Jira caps that at ~50). order_by accepts \'created\' or \'-created\' for ascending/descending. ADF bodies auto-flattened.","params_added":["async_run","deadline_ms","issue_key","max_results","order_by","start_at","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_get_issue","change":"added","description_changed":false,"description":"Fetch a single Jira issue by key (e.g. \'PROJ-123\'). Returns full detail including description, parent, sub-tasks, issue_links (with link ids for jira_delete_link), and attachment metadata. Pass `expand: [\'remoteLinks\']` to also fetch web/Confluence/GitHub links. Pass `custom_fields` (display names like \'Vulnerability Description\', or `customfield_NNNNN` ids) to include them in the response under a `custom_fields` map. Pass `include_comments: true` to include flattened comment bodies (author, timestamps, text). ADF/rich-text is auto-flattened. **PREFER THIS over shell-exec\'ing the jira CLI.**","params_added":["async_run","custom_fields","deadline_ms","expand","include_comments","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_get_project","change":"added","description_changed":false,"description":"Fetch a single Jira project by key. Optionally include versions, components, and/or issue types in the response — saves separate calls for the common \'tell me about this project\' use case.","params_added":["async_run","deadline_ms","include_components","include_issue_types","include_versions","project_key","stream"],"params_removed":[],"params_changed":[],"required_added":["project_key"],"required_removed":[]},{"name":"jira_get_sprint","change":"added","description_changed":false,"description":"Fetch a single sprint by id. Returns name, state, goal, start/end/complete dates. Use jira_search with `sprint = {id}` to list its issues.","params_added":["async_run","deadline_ms","sprint_id","stream"],"params_removed":[],"params_changed":[],"required_added":["sprint_id"],"required_removed":[]},{"name":"jira_link_issues","change":"added","description_changed":false,"description":"Create an issue link between two Jira issues (Blocks, Relates, Duplicates, Cloners, etc.). The link reads left-to-right: \'from_issue <outward verb> to_issue\'. For example, { from_issue: \'A-1\', to_issue: \'B-2\', link_type: \'Blocks\' } means \'A-1 blocks B-2\' (and \'B-2 is blocked by A-1\' shows on the other side automatically). Call without arguments to list available link types for the site. **PREFER THIS over shell-exec\'ing the jira CLI or hitting REST directly.** Disable to make the agent read-only.","params_added":["async_run","comment","deadline_ms","from_issue","link_type","stream","to_issue"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"jira_list_boards","change":"added","description_changed":false,"description":"List Jira agile boards (Scrum or Kanban). Filter by project key, name fragment, or board type. Returns id, name, type, project_key. Use the id with jira_list_sprints / jira_get_backlog / etc.","params_added":["async_run","deadline_ms","max_results","name","project","stream","type"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"jira_list_components","change":"added","description_changed":false,"description":"List components on a Jira project. Returns id, name, description, lead, default assignee type. Components are not paginated by Jira — the full list returns in one call.","params_added":["async_run","deadline_ms","project_key","stream"],"params_removed":[],"params_changed":[],"required_added":["project_key"],"required_removed":[]},{"name":"jira_list_meta","change":"added","description_changed":false,"description":"List values for a Jira site-wide enum: issue types, priorities, statuses, or resolutions. Pass `kind` = \'issue_type\' | \'priority\' | \'status\' | \'resolution\'. Omit `kind` to list available kinds. Use this before jira_create_issue / jira_update_issue when you don\'t know the exact name on this site.","params_added":["async_run","deadline_ms","kind","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"jira_list_projects","change":"added","description_changed":false,"description":"List Jira projects (paginated). Filter by name fragment via `query` or by category. Returns id, key, name, type, style (\'classic\'|\'next-gen\'), lead.","params_added":["async_run","category_id","deadline_ms","max_results","query","start_at","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"jira_list_sprints","change":"added","description_changed":false,"description":"List sprints on a board. Filter by state (\'active\', \'closed\', \'future\'). Returns sprint id, name, state, goal, dates, origin_board_id. To list issues IN a sprint, use jira_search with JQL `sprint = {id}` — that\'s faster and supports custom field selection.","params_added":["async_run","board_id","deadline_ms","max_results","state","stream"],"params_removed":[],"params_changed":[],"required_added":["board_id"],"required_removed":[]},{"name":"jira_list_versions","change":"added","description_changed":false,"description":"List versions on a Jira project (paginated). Returns id, name, released/archived flags, dates. Use jira_create_version to add a new one and jira_update_version to release/archive.","params_added":["async_run","deadline_ms","max_results","order_by","project_key","start_at","stream"],"params_removed":[],"params_changed":[],"required_added":["project_key"],"required_removed":[]},{"name":"jira_list_worklogs","change":"added","description_changed":false,"description":"List worklog entries on a Jira issue (paginated). Returns id, author, time_spent (display string + seconds), started, comment. Use to compute totals or audit time tracking.","params_added":["async_run","deadline_ms","issue_key","max_results","start_at","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_move_issues_to_backlog","change":"added","description_changed":false,"description":"Remove issues from their current sprint and put them back on the backlog. Up to 50 issues per call. Pass `board_id` for Kanban boards (the unscoped endpoint only works for Scrum). For Scrum, board_id is optional but recommended for clarity.","params_added":["async_run","board_id","deadline_ms","issue_keys","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_keys"],"required_removed":[]},{"name":"jira_move_issues_to_sprint","change":"added","description_changed":false,"description":"Move issues into a sprint. Up to 50 issues per call. Issues already in another sprint are transparently moved (no separate remove step needed). Use jira_move_issues_to_backlog to remove issues from sprints without putting them in a new one.","params_added":["async_run","deadline_ms","issue_keys","sprint_id","stream"],"params_removed":[],"params_changed":[],"required_added":["issue_keys","sprint_id"],"required_removed":[]},{"name":"jira_rank_issues","change":"added","description_changed":false,"description":"Rank up to 50 issues relative to a single anchor issue (before XOR after). Pass rank_custom_field_id only on sites that have a non-default rank field — get it from jira_get_board.configuration.ranking_field. Order within `issues[]` is preserved.","params_added":["async_run","deadline_ms","issues","rank_after_issue","rank_before_issue","rank_custom_field_id","stream"],"params_removed":[],"params_changed":[],"required_added":["issues"],"required_removed":[]},{"name":"jira_search","change":"added","description_changed":false,"description":"Search Jira issues using JQL. **PREFER THIS over shell-exec\'ing the jira CLI** — this tool uses the configured Atlassian credentials directly via REST. Returns key, summary, status, assignee. JQL examples: \'assignee = currentUser() AND resolution = Unresolved\', \'project = ABC AND status = \\"In Progress\\"\', \'updated >= -7d ORDER BY updated DESC\'.","params_added":["async_run","deadline_ms","fields","jql","max_results","stream"],"params_removed":[],"params_changed":[],"required_added":["jql"],"required_removed":[]},{"name":"jira_transition_issue","change":"added","description_changed":false,"description":"Transition a Jira issue\'s status (e.g. \'In Progress\' → \'Done\'). Call without transition_name to list available transitions for the issue. **PREFER THIS over shell-exec\'ing the jira CLI.**","params_added":["async_run","deadline_ms","issue_key","stream","transition_name"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_update_comment","change":"added","description_changed":false,"description":"Edit an existing comment on a Jira issue. Plain-text body is auto-converted to ADF (same as jira_add_comment). The author and created timestamp are preserved; updated reflects this edit.","params_added":["async_run","body","comment_id","deadline_ms","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["body","comment_id","issue_key"],"required_removed":[]},{"name":"jira_update_issue","change":"added","description_changed":false,"description":"Edit fields on an existing Jira issue: summary, description, priority, assignee, fix versions, labels, and arbitrary custom fields (including \'Due Date\' and \'Story Points\' on sites where those are custom). Pass only the fields you want to change. Description is auto-converted from plain text to ADF. Labels support either full replace (`labels`) or incremental `labels_add`/`labels_remove`. Assignee can be set by `assignee_account_id` or by `assignee_email` (auto-resolved); pass null/\\"unassigned\\" to clear. Custom fields accept display names (\'Due Date\') or ids (\'customfield_10015\'); values are …","params_added":["assignee_account_id","assignee_email","async_run","custom_fields","deadline_ms","description","fix_versions","issue_key","labels","labels_add","labels_remove","parent_key","priority","stream","summary"],"params_removed":[],"params_changed":[],"required_added":["issue_key"],"required_removed":[]},{"name":"jira_update_sprint","change":"added","description_changed":false,"description":"Update a sprint\'s name, goal, dates, or state. State transitions: future→active (start) or active→closed (complete). Other transitions are rejected client-side with the list of legal next states. Pass only the fields you want to change. **Disable to make the agent unable to start/complete sprints.**","params_added":["async_run","deadline_ms","end_date","goal","name","sprint_id","start_date","state","stream"],"params_removed":[],"params_changed":[],"required_added":["sprint_id"],"required_removed":[]},{"name":"jira_update_version","change":"added","description_changed":false,"description":"Edit a version: rename, change dates, mark released/unreleased, mark archived/unarchived. Pass only the fields you want to change. To \'release\' a version, pass released=true (and release_date if not already set). To unrelease, pass released=false. **Disable to make the agent unable to release versions.**","params_added":["archived","async_run","deadline_ms","description","name","release_date","released","start_date","stream","version_id"],"params_removed":[],"params_changed":[],"required_added":["version_id"],"required_removed":[]},{"name":"jira_upload_attachment","change":"added","description_changed":false,"description":"Upload a file as an attachment to a Jira issue. Pass content_base64 for binary files (PNG, PDF, ZIP, etc.) or content_text for plain UTF-8 text (logs, CSVs, JSON). The agent itself reads/encodes the source file — this tool only handles the upload. **PREFER THIS over pasting file contents into a comment.** Disable to make the agent unable to add attachments.","params_added":["async_run","content_base64","content_text","deadline_ms","filename","issue_key","stream"],"params_removed":[],"params_changed":[],"required_added":["filename","issue_key"],"required_removed":[]},{"name":"ms_todo_add_checklist_item","change":"added","description_changed":false,"description":"Append a checklist sub-item (step) to a Microsoft To Do task. Pass `is_checked: true` to add an already-completed step (rare; usually omit).","params_added":["async_run","deadline_ms","is_checked","list_id","name","stream","task_id"],"params_removed":[],"params_changed":[],"required_added":["list_id","name","task_id"],"required_removed":[]},{"name":"ms_todo_complete_task","change":"added","description_changed":false,"description":"Mark a Microsoft To Do task as completed (status=\'completed\'). Convenience wrapper around ms_todo_update_task for the dominant \'tick it off\' case. Graph automatically populates completedDateTime.","params_added":["async_run","deadline_ms","list_id","stream","task_id"],"params_removed":[],"params_changed":[],"required_added":["list_id","task_id"],"required_removed":[]},{"name":"ms_todo_create_list","change":"added","description_changed":false,"description":"Create a new Microsoft To Do task list. Returns the new list\'s id and metadata. List names must be unique per user; reusing a name yields a 409.","params_added":["async_run","deadline_ms","name","stream"],"params_removed":[],"params_changed":[],"required_added":["name"],"required_removed":[]},{"name":"ms_todo_create_task","change":"added","description_changed":false,"description":"Create a new Microsoft To Do task. `due_iso` and `reminder_iso` are RFC3339 strings interpreted in UTC unless paired with an IANA timezone. Setting `reminder_iso` automatically turns on the reminder. Use ms_todo_list_lists to find the target list_id; pass the default list\'s id to put the task in the user\'s main \'Tasks\' inbox.","params_added":["async_run","body","categories","deadline_ms","due_iso","due_time_zone","importance","list_id","reminder_iso","reminder_time_zone","stream","title"],"params_removed":[],"params_changed":[],"required_added":["list_id","title"],"required_removed":[]},{"name":"ms_todo_delete_list","change":"added","description_changed":false,"description":"Permanently delete a Microsoft To Do task list and all its tasks. The default list and well-known lists cannot be deleted. This action is irreversible — confirm with the user before invoking.","params_added":["async_run","deadline_ms","list_id","stream"],"params_removed":[],"params_changed":[],"required_added":["list_id"],"required_removed":[]},{"name":"ms_todo_delete_task","change":"added","description_changed":false,"description":"Permanently delete a Microsoft To Do task. This action is irreversible — confirm with the user before invoking. For \'mark as done\' use ms_todo_complete_task instead.","params_added":["async_run","deadline_ms","list_id","stream","task_id"],"params_removed":[],"params_changed":[],"required_added":["list_id","task_id"],"required_removed":[]},{"name":"ms_todo_get_task","change":"added","description_changed":false,"description":"Fetch one Microsoft To Do task by id. Returns the same slim shape as ms_todo_list_tasks but with the full body field included.","params_added":["async_run","deadline_ms","list_id","stream","task_id"],"params_removed":[],"params_changed":[],"required_added":["list_id","task_id"],"required_removed":[]},{"name":"ms_todo_list_checklist_items","change":"added","description_changed":false,"description":"List the checklist sub-items (steps) of a Microsoft To Do task. Each item has its own id, display name, and is_checked flag. Useful for breaking a complex task into ordered steps.","params_added":["async_run","deadline_ms","list_id","stream","task_id"],"params_removed":[],"params_changed":[],"required_added":["list_id","task_id"],"required_removed":[]},{"name":"ms_todo_list_lists","change":"added","description_changed":false,"description":"List the user\'s Microsoft To Do task lists. Returns id, name, ownership, shared flag, and wellknownListName (e.g. \'defaultList\' for the Tasks inbox, \'flaggedEmails\' for the auto-list of flagged Outlook mail). Use the returned `id` with the other ms_todo_* tools as `list_id`. Call this first when the user refers to a list by name.","params_added":["async_run","deadline_ms","stream"],"params_removed":[],"params_changed":[],"required_added":[],"required_removed":[]},{"name":"ms_todo_list_tasks","change":"added","description_changed":false,"description":"List tasks in a Microsoft To Do list with optional filters. Defaults: newest first, top 50, no filter. Filter by `status` (notStarted | inProgress | completed | waitingOnOthers | deferred), `importance` (low | normal | high), and/or a `due_before`/`due_after` window (RFC3339). Call ms_todo_list_lists first to resolve the user\'s list name to an id.","params_added":["async_run","deadline_ms","due_after","due_before","importance","list_id","max_results","status","stream"],"params_removed":[],"params_changed":[],"required_added":["list_id"],"required_removed":[]},{"name":"ms_todo_update_list","change":"added","description_changed":false,"description":"Rename an existing Microsoft To Do task list. The default \'Tasks\' list (wellknownListName=defaultList) cannot be renamed and returns a 400.","params_added":["async_run","deadline_ms","list_id","name","stream"],"params_removed":[],"params_changed":[],"required_added":["list_id","name"],"required_removed":[]},{"name":"ms_todo_update_task","change":"added","description_changed":false,"description":"Patch a Microsoft To Do task. Only supplied fields are changed; omit fields to leave them alone. Pass `clear_due: true` or `clear_reminder: true` to remove a date that was previously set. Use ms_todo_complete_task for the common \'mark done\' case — it\'s a thin wrapper over this with status=\'completed\'.","params_added":["async_run","body","categories","clear_due","clear_reminder","deadline_ms","due_iso","due_time_zone","importance","list_id","reminder_iso","reminder_time_zone","status","stream","task_id","title"],"params_removed":[],"params_changed":[],"required_added":["list_id","task_id"],"required_removed":[]}]}]}');
 ;// ./lib/lifecycle/changesets.ts
 /**
  * Bundled release changesets (docs/adoption/changesets.json), generated at
@@ -15451,6 +15520,8 @@ const compactContextTool = (0,tools/* tool */.z6)(async (_input, config)=>{
 var default_packages = __webpack_require__(64611);
 // EXTERNAL MODULE: ./lib/tools/communications/gmail.ts
 var gmail = __webpack_require__(71941);
+// EXTERNAL MODULE: ./lib/utils/source-link.ts
+var source_link = __webpack_require__(76385);
 // EXTERNAL MODULE: ./lib/integrations/gmail-oauth.ts
 var gmail_oauth = __webpack_require__(7721);
 ;// ./lib/tools/communications/calendar.ts
@@ -15481,6 +15552,7 @@ var gmail_oauth = __webpack_require__(7721);
 
 
 
+
 const CALENDAR_BASE = "https://www.googleapis.com/calendar/v3";
 const calendarFetch = (auth, path, init)=>(0,gmail_oauth/* googleFetch */.sI)(auth, "Calendar", CALENDAR_BASE, path, init);
 const RFC3339_DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
@@ -15503,7 +15575,8 @@ function slimEvent(e) {
                 response: a.responseStatus ?? null
             })),
         meet_link: e.hangoutLink ?? null,
-        html_link: e.htmlLink ?? null
+        html_link: e.htmlLink ?? null,
+        cite_as: (0,source_link/* citeAs */.w)(e.summary, e.htmlLink, "Calendar event")
     };
 }
 // ── Tools ───────────────────────────────────────────────────────────────────
@@ -15785,6 +15858,7 @@ var microsoft_oauth = __webpack_require__(46291);
 
 
 
+
 function outlook_calendar_slimEvent(e) {
     return {
         id: e.id,
@@ -15803,7 +15877,8 @@ function outlook_calendar_slimEvent(e) {
         is_cancelled: e.isCancelled === true,
         show_as: e.showAs ?? null,
         teams_link: e.onlineMeeting?.joinUrl ?? null,
-        web_link: e.webLink ?? null
+        web_link: e.webLink ?? null,
+        cite_as: (0,source_link/* citeAs */.w)(e.subject, e.webLink, "Outlook event")
     };
 }
 // ── Tools ───────────────────────────────────────────────────────────────────
@@ -21782,12 +21857,17 @@ function upsertAgentConfigTransaction(input) {
     const db = (0,_lib_db__WEBPACK_IMPORTED_MODULE_0__/* .getDb */ .L)();
     const existing = getAgentConfig(input.id);
     const created_at = existing?.created_at ?? t;
-    const mbti = input.adaptive_mbti ?? toMbti(existing?.adaptive_mbti) ?? "INTJ";
+    const existingMbti = toMbti(existing?.adaptive_mbti);
+    const mbti = input.adaptive_mbti ?? existingMbti ?? "INTJ";
     const preset = _lib_agents_adaptive_persona_presets__WEBPACK_IMPORTED_MODULE_2__/* .MBTI_PRESETS */ .e[mbti];
-    const strength = input.adaptive_persona_strength ?? preset.strength;
-    const empathy = input.adaptive_empathy ?? preset.empathy;
-    const expressiveness = input.adaptive_expressiveness ?? preset.expressiveness;
-    const verbosity = input.adaptive_verbosity ?? preset.verbosity;
+    // Omitted sliders keep their tuned values; they only fall back to the
+    // preset when the type changes or the agent is new. Otherwise every
+    // partial update (approved proposals, tool edits) reset them.
+    const keepTuned = existing !== null && existing !== undefined && mbti === existingMbti;
+    const strength = input.adaptive_persona_strength ?? (keepTuned ? existing.adaptive_persona_strength : preset.strength);
+    const empathy = input.adaptive_empathy ?? (keepTuned ? existing.adaptive_empathy : preset.empathy);
+    const expressiveness = input.adaptive_expressiveness ?? (keepTuned ? existing.adaptive_expressiveness : preset.expressiveness);
+    const verbosity = input.adaptive_verbosity ?? (keepTuned ? existing.adaptive_verbosity : preset.verbosity);
     if (input.is_default) db.prepare("UPDATE agent_configs SET is_default=0").run();
     // harness_id: explicit `undefined` means "keep existing"; explicit `null`
     // means "use the global default". Empty string is normalised to null too,
@@ -22023,23 +22103,27 @@ async function readToolResultRef(args) {
     }
     const offset = Math.max(0, Math.floor(args.offset ?? 0));
     const limit = Math.min(MAX_READ_BYTES, Math.max(1, Math.floor(args.limit ?? DEFAULT_PREVIEW_BYTES)));
-    let buf;
     try {
         const file = await node_fs__WEBPACK_IMPORTED_MODULE_0__.promises.open(abs, "r");
         try {
             const stat = await file.stat();
-            const readLength = Math.max(0, Math.min(limit, stat.size - offset));
-            buf = Buffer.alloc(readLength);
-            if (readLength > 0) await file.read(buf, 0, readLength, offset);
-            const nextOffset = offset + readLength;
+            // Read a few bytes either side so the window can be moved onto UTF-8
+            // character boundaries; paging must never split a multi-byte character.
+            const windowStart = Math.min(Math.max(0, offset - 3), stat.size);
+            const windowLength = Math.max(0, Math.min(stat.size - windowStart, offset - windowStart + limit + 3));
+            const buf = Buffer.alloc(windowLength);
+            if (windowLength > 0) await file.read(buf, 0, windowLength, windowStart);
+            const { start, end } = utf8Window(buf, Math.min(offset, stat.size) - windowStart, limit);
+            const actualOffset = windowStart + start;
+            const nextOffset = windowStart + end;
             return {
                 ok: true,
                 status: "done",
                 name: args.name,
-                offset,
+                offset: actualOffset,
                 limit,
                 bytes: stat.size,
-                result: buf.toString("utf8"),
+                result: buf.subarray(start, end).toString("utf8"),
                 next_offset: nextOffset < stat.size ? nextOffset : null,
                 done: nextOffset >= stat.size
             };
@@ -22055,6 +22139,26 @@ async function readToolResultRef(args) {
         };
     }
 }
+const isUtf8Continuation = (byte)=>byte !== undefined && (byte & 0xc0) === 0x80;
+// Moves `[start, start + limit)` inside `buf` onto character boundaries: the
+// start backs up to its lead byte, and the end backs up so it does not cut a
+// character — unless that character alone exceeds `limit`, in which case the
+// whole character is returned so paging always makes progress.
+function utf8Window(buf, start, limit) {
+    let s = Math.max(0, Math.min(start, buf.length));
+    while(s > 0 && isUtf8Continuation(buf[s]))s--;
+    let e = Math.min(buf.length, s + limit);
+    if (e < buf.length && isUtf8Continuation(buf[e])) {
+        let lead = e;
+        while(lead > s && isUtf8Continuation(buf[lead]))lead--;
+        if (lead > s) e = lead;
+        else while(e < buf.length && isUtf8Continuation(buf[e]))e++;
+    }
+    return {
+        start: s,
+        end: e
+    };
+}
 function serializeToolResult(result) {
     if (typeof result === "string") return result;
     return JSON.stringify(result) ?? String(result);
@@ -22072,10 +22176,21 @@ function buildPreview(value, mimeType) {
         try {
             const parsed = JSON.parse(value);
             if (Array.isArray(parsed)) {
-                const preview = parsed.slice(0, JSON_ARRAY_PREVIEW_ITEMS);
+                // Cap by bytes as well as items: a few huge rows must not smuggle the
+                // whole result back inline.
+                for(let n = Math.min(parsed.length, JSON_ARRAY_PREVIEW_ITEMS); n > 0; n--){
+                    const preview = parsed.slice(0, n);
+                    const bytes = Buffer.byteLength(JSON.stringify(preview));
+                    if (bytes <= DEFAULT_PREVIEW_BYTES) return {
+                        value: preview,
+                        bytes,
+                        total_count: parsed.length
+                    };
+                }
+                const text = takeUtf8Prefix(value, DEFAULT_PREVIEW_BYTES);
                 return {
-                    value: preview,
-                    bytes: Buffer.byteLength(JSON.stringify(preview)),
+                    value: text,
+                    bytes: Buffer.byteLength(text),
                     total_count: parsed.length
                 };
             }
@@ -22098,6 +22213,8 @@ function takeUtf8Prefix(value, maxBytes) {
         if (Buffer.byteLength(value.slice(0, mid)) <= maxBytes) lo = mid;
         else hi = mid - 1;
     }
+    const code = value.charCodeAt(lo - 1);
+    if (lo > 0 && code >= 0xd800 && code <= 0xdbff) lo--;
     return value.slice(0, lo);
 }
 function safeToolName(name) {
@@ -26018,8 +26135,21 @@ const MEMORY_WRITE_NAMESPACES = new Set([
 function rowsInRange(rows, topic) {
     return rows.filter((row)=>row.seq >= (topic.start_seq ?? Infinity) && row.seq <= (topic.end_seq ?? -Infinity));
 }
+// Unicode-aware so non-Latin subjects get distinct keys; an ASCII-only slug
+// collapsed them all to "" and the uplift skipped them. Subjects with no
+// letters or digits fall back to a stable hash.
 function slugifyForMemoryKey(subject) {
-    return subject.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+    const slug = subject.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "");
+    const capped = Array.from(slug).slice(0, 80).join("").replace(/-+$/, "");
+    return capped || `fact-${fnv1a(subject)}`;
+}
+function fnv1a(text) {
+    let hash = 0x811c9dc5;
+    for(let i = 0; i < text.length; i++){
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
 }
 /**
  * Merge facts by subject (case-insensitive) and memory key. Later entries win,
@@ -26031,9 +26161,18 @@ function slugifyForMemoryKey(subject) {
     for (const list of lists){
         for (const fact of list){
             const subjectId = fact.subject.trim().toLowerCase();
-            const existingSubject = fact.key ? keyToSubject.get(fact.key) : undefined;
-            if (existingSubject && existingSubject !== subjectId) merged.delete(existingSubject);
-            merged.delete(subjectId);
+            const sameKeySubject = fact.key ? keyToSubject.get(fact.key) : undefined;
+            for (const replaced of [
+                sameKeySubject,
+                subjectId
+            ]){
+                if (replaced === undefined) continue;
+                // Drop the replaced fact's key mapping too, so a later fact reusing
+                // that key cannot delete whatever now lives under this subject.
+                const previousKey = merged.get(replaced)?.key;
+                if (previousKey) keyToSubject.delete(previousKey);
+                merged.delete(replaced);
+            }
             merged.set(subjectId, fact);
             if (fact.key) keyToSubject.set(fact.key, subjectId);
         }
@@ -29862,14 +30001,15 @@ function stripWrapperFields(args) {
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   Wz: () => (/* binding */ _resolveGmailAuth)
 /* harmony export */ });
-/* unused harmony exports buildRawMessage, gmailSearchTool, gmailGetMessageTool, gmailListLabelsTool, gmailModifyMessageTool, gmailCreateDraftTool, gmailSendEmailTool, gmailTrashMessageTool */
+/* unused harmony exports gmailWebLink, buildRawMessage, gmailSearchTool, gmailGetMessageTool, gmailListLabelsTool, gmailModifyMessageTool, gmailCreateDraftTool, gmailSendEmailTool, gmailTrashMessageTool */
 /* harmony import */ var _langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(49585);
-/* harmony import */ var zod__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(17033);
+/* harmony import */ var zod__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(17033);
 /* harmony import */ var _lib_utils_html__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(85212);
-/* harmony import */ var _lib_utils_text__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(69494);
+/* harmony import */ var _lib_utils_text__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(69494);
 /* harmony import */ var _packages_langchain_package__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(18932);
 /* harmony import */ var _lib_integrations_gmail_oauth__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(7721);
 /* harmony import */ var _lib_utils_error__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(4379);
+/* harmony import */ var _lib_utils_source_link__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(76385);
 /**
  * Native Gmail tools — direct REST API calls to gmail.googleapis.com, no MCP.
  *
@@ -29897,6 +30037,7 @@ function stripWrapperFields(args) {
 
 
 
+
 // Exposed for the integrations test endpoint.
 function _resolveGmailAuth() {
     return (0,_lib_integrations_gmail_oauth__WEBPACK_IMPORTED_MODULE_2__/* .resolveGoogleAuth */ .wq)();
@@ -29921,6 +30062,31 @@ function resolveGmailAuthForTool() {
         };
     }
 }
+// ── Source links ────────────────────────────────────────────────────────────
+// Gmail's web URL scheme is undocumented. `#all/<threadId>` opens the
+// conversation from All Mail whatever its labels, and `/u/<email>/` selects
+// the signed-in account (`/u/0/` is whichever account signed in first).
+const GMAIL_API_ID = /^[0-9a-f]{8,32}$/i;
+function gmailWebLink(threadId, account) {
+    if (!threadId || !GMAIL_API_ID.test(threadId)) return null;
+    const slot = account ? encodeURIComponent(account) : "0";
+    return `https://mail.google.com/mail/u/${slot}/#all/${threadId}`;
+}
+const accountEmailCache = new Map();
+// getProfile works with every Gmail scope; a failure only drops the account
+// from the link, so it is not retried within the process.
+function gmailAccountEmail(auth) {
+    const key = auth.refresh_token.slice(0, 20);
+    let pending = accountEmailCache.get(key);
+    if (!pending) {
+        pending = gmailFetch(auth, "/profile").then((p)=>{
+            const email = p.emailAddress;
+            return typeof email === "string" && email.includes("@") ? email : null;
+        }).catch(()=>null);
+        accountEmailCache.set(key, pending);
+    }
+    return pending;
+}
 // ── Decoders / helpers ──────────────────────────────────────────────────────
 // Gmail uses base64url (no padding, +/ → -_). Node's Buffer handles it directly.
 function decodeBase64Url(s) {
@@ -29993,6 +30159,7 @@ const gmailSearchTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/*
             messages: []
         });
     }
+    const account = await gmailAccountEmail(auth);
     // Parallel metadata fetch; the API recommends batching but for ≤100 ids
     // parallel single calls are simpler and well within quota.
     const details = await Promise.all(ids.map(async (id)=>{
@@ -30001,15 +30168,19 @@ const gmailSearchTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/*
             id,
             error: m.error
         };
+        const subject = header(m.payload?.headers, "Subject");
+        const webLink = gmailWebLink(m.threadId, account);
         return {
             id: m.id,
             thread_id: m.threadId,
             from: header(m.payload?.headers, "From"),
             to: header(m.payload?.headers, "To"),
-            subject: header(m.payload?.headers, "Subject"),
+            subject,
             date: header(m.payload?.headers, "Date"),
             snippet: m.snippet ?? null,
-            labels: m.labelIds ?? []
+            labels: m.labelIds ?? [],
+            web_link: webLink,
+            cite_as: (0,_lib_utils_source_link__WEBPACK_IMPORTED_MODULE_5__/* .citeAs */ .w)(subject, webLink, "Gmail message")
         };
     }));
     return JSON.stringify({
@@ -30021,9 +30192,9 @@ const gmailSearchTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/*
 }, {
     name: "gmail_search",
     description: "Search the user's Gmail with Gmail query syntax. Returns message metadata (from, to, subject, " + "date, snippet, labels) plus Gmail's resultSizeEstimate and next page token so '1 result' " + "doesn't get mistaken for '1 unread email'. Examples: 'is:unread newer_than:1d', " + "'from:notifications@github.com', 'subject:invoice has:attachment', 'in:inbox -category:promotions'. " + "Use this before calling gmail_get_message — the snippet is often enough.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        query: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().describe("Gmail query string"),
-        max_results: zod__WEBPACK_IMPORTED_MODULE_5__/* .number */ .aig().int().optional().describe("Max messages (default 25, max 100)")
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        query: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().describe("Gmail query string"),
+        max_results: zod__WEBPACK_IMPORTED_MODULE_6__/* .number */ .aig().int().optional().describe("Max messages (default 25, max 100)")
     })
 });
 const gmailGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ id })=>{
@@ -30032,15 +30203,19 @@ const gmailGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0_
     const m = await gmailFetch(auth, `/messages/${encodeURIComponent(id)}?format=full`);
     if (m.error) return JSON.stringify(m);
     const body = extractBody(m.payload);
-    const { text: capped, truncated } = (0,_lib_utils_text__WEBPACK_IMPORTED_MODULE_6__/* .truncateBytes */ .Q)(body, MAX_BODY_BYTES);
+    const { text: capped, truncated } = (0,_lib_utils_text__WEBPACK_IMPORTED_MODULE_7__/* .truncateBytes */ .Q)(body, MAX_BODY_BYTES);
+    const subject = header(m.payload?.headers, "Subject");
+    const webLink = gmailWebLink(m.threadId, await gmailAccountEmail(auth));
     return JSON.stringify({
         id: m.id,
         thread_id: m.threadId,
+        web_link: webLink,
+        cite_as: (0,_lib_utils_source_link__WEBPACK_IMPORTED_MODULE_5__/* .citeAs */ .w)(subject, webLink, "Gmail message"),
         labels: m.labelIds ?? [],
         from: header(m.payload?.headers, "From"),
         to: header(m.payload?.headers, "To"),
         cc: header(m.payload?.headers, "Cc"),
-        subject: header(m.payload?.headers, "Subject"),
+        subject,
         date: header(m.payload?.headers, "Date"),
         message_id: header(m.payload?.headers, "Message-Id") ?? header(m.payload?.headers, "Message-ID"),
         snippet: m.snippet ?? null,
@@ -30050,8 +30225,8 @@ const gmailGetMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0_
 }, {
     name: "gmail_get_message",
     description: "Fetch one Gmail message by id, including full headers and the decoded text body (text/plain " + "preferred, HTML stripped if only HTML is available). Body capped at 30KB with `truncated:true` " + "when cut off.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().describe("Gmail message id (from gmail_search results)")
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().describe("Gmail message id (from gmail_search results)")
     })
 });
 const gmailListLabelsTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ()=>{
@@ -30069,7 +30244,7 @@ const gmailListLabelsTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0_
 }, {
     name: "gmail_list_labels",
     description: "List all Gmail labels (system + user). System label ids are uppercase (INBOX, UNREAD, " + "STARRED, IMPORTANT, SPAM, TRASH, SENT, DRAFT, CATEGORY_*). User labels have lowercase " + "alphanumeric ids like 'Label_42'. Use the id values with gmail_modify_message.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({})
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({})
 });
 const gmailModifyMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ id, add_labels, remove_labels })=>{
     const auth = resolveGmailAuthForTool();
@@ -30095,10 +30270,10 @@ const gmailModifyMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE
 }, {
     name: "gmail_modify_message",
     description: "Add or remove labels on a Gmail message. Common patterns: " + "archive = remove_labels=['INBOX']; mark read = remove_labels=['UNREAD']; " + "star = add_labels=['STARRED']; mark important = add_labels=['IMPORTANT']. " + "Use gmail_list_labels first if you don't know a user label id.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().describe("Gmail message id"),
-        add_labels: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional().describe("Label ids to add"),
-        remove_labels: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional().describe("Label ids to remove")
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().describe("Gmail message id"),
+        add_labels: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional().describe("Label ids to add"),
+        remove_labels: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional().describe("Label ids to remove")
     })
 });
 const gmailCreateDraftTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ to, cc, bcc, subject, body, content_type, in_reply_to_id })=>{
@@ -30153,17 +30328,17 @@ const gmailCreateDraftTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0
 }, {
     name: "gmail_create_draft",
     description: "Create a Gmail draft. Prefer drafts unless the user explicitly asks to send immediately. " + "`content_type` defaults to 'text'; pass 'html' if `body` contains HTML markup. " + "When replying to an existing message, pass `in_reply_to_id` (the parent " + "message id from gmail_search/gmail_get_message) — the tool will set Message-Id/References/" + "threadId so the draft appears inside the right Gmail thread.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        to: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).describe("Recipient email addresses"),
-        cc: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional(),
-        bcc: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional(),
-        subject: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP(),
-        body: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().max(DRAFT_BODY_MAX_CHARS).describe("Email body (max 100,000 characters)"),
-        content_type: zod__WEBPACK_IMPORTED_MODULE_5__/* ["enum"] */ .k5n([
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        to: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).describe("Recipient email addresses"),
+        cc: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional(),
+        bcc: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional(),
+        subject: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP(),
+        body: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().max(DRAFT_BODY_MAX_CHARS).describe("Email body (max 100,000 characters)"),
+        content_type: zod__WEBPACK_IMPORTED_MODULE_6__/* ["enum"] */ .k5n([
             "text",
             "html"
         ]).optional().describe("Body content type (default 'text')"),
-        in_reply_to_id: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().optional().describe("Gmail message id to reply to (for threading)")
+        in_reply_to_id: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().optional().describe("Gmail message id to reply to (for threading)")
     })
 });
 const gmailSendEmailTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ to, cc, bcc, subject, body, content_type, in_reply_to_id })=>{
@@ -30213,17 +30388,17 @@ const gmailSendEmailTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__
 }, {
     name: "gmail_send_email",
     description: "Send a Gmail email immediately. Only use when the user explicitly asks to send now; " + "otherwise create a draft with gmail_create_draft. Supports text or HTML bodies via `content_type`. " + "When replying, pass `in_reply_to_id` so Gmail threads the sent message correctly.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        to: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).min(1).describe("Recipient email addresses"),
-        cc: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional(),
-        bcc: zod__WEBPACK_IMPORTED_MODULE_5__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP()).optional(),
-        subject: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP(),
-        body: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().max(SEND_BODY_MAX_CHARS).describe("Email body (max 100,000 characters)"),
-        content_type: zod__WEBPACK_IMPORTED_MODULE_5__/* ["enum"] */ .k5n([
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        to: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).min(1).describe("Recipient email addresses"),
+        cc: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional(),
+        bcc: zod__WEBPACK_IMPORTED_MODULE_6__/* .array */ .YOg(zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP()).optional(),
+        subject: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP(),
+        body: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().max(SEND_BODY_MAX_CHARS).describe("Email body (max 100,000 characters)"),
+        content_type: zod__WEBPACK_IMPORTED_MODULE_6__/* ["enum"] */ .k5n([
             "text",
             "html"
         ]).optional().describe("Body content type (default 'text')"),
-        in_reply_to_id: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().optional().describe("Gmail message id to reply to (for threading)")
+        in_reply_to_id: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().optional().describe("Gmail message id to reply to (for threading)")
     })
 });
 const gmailTrashMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_0__/* .tool */ .z6)(async ({ id })=>{
@@ -30241,8 +30416,8 @@ const gmailTrashMessageTool = (0,_langchain_core_tools__WEBPACK_IMPORTED_MODULE_
 }, {
     name: "gmail_trash_message",
     description: "Move a Gmail message to Trash (reversible for 30 days, not permanent delete). Only call this " + "when the user has explicitly asked to trash/delete a message — never on your own initiative " + "as part of a triage flow. Prefer gmail_modify_message remove_labels=['INBOX'] to archive.",
-    schema: zod__WEBPACK_IMPORTED_MODULE_5__/* .object */ .Ikc({
-        id: zod__WEBPACK_IMPORTED_MODULE_5__/* .string */ .YjP().describe("Gmail message id")
+    schema: zod__WEBPACK_IMPORTED_MODULE_6__/* .object */ .Ikc({
+        id: zod__WEBPACK_IMPORTED_MODULE_6__/* .string */ .YjP().describe("Gmail message id")
     })
 });
 (0,_packages_langchain_package__WEBPACK_IMPORTED_MODULE_1__/* .registerLangChainPackage */ .p)({
@@ -31422,6 +31597,51 @@ async function indexAllSources(opts) {
 }
 
 
+/***/ }),
+
+/***/ 76385:
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   w: () => (/* binding */ citeAs)
+/* harmony export */ });
+/* unused harmony export httpsUrlOrNull */
+/**
+ * Source-link fields for tool results, so an agent can link a reply back to
+ * the email, calendar event, or chat it came from without building URLs.
+ *
+ * `cite_as` is a ready-made markdown link the system prompt tells agents to
+ * paste verbatim. Building it in code keeps the label and URL well-formed:
+ * a stray `]` in a subject or `)` in a URL would otherwise break the link.
+ */ const MAX_LABEL_CHARS = 80;
+/** Returns `url` when it is an absolute https URL, otherwise null. */ function httpsUrlOrNull(url) {
+    if (!url) return null;
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === "https:" ? parsed.href : null;
+    } catch  {
+        return null;
+    }
+}
+function markdownLabel(label, fallback) {
+    const flat = (label ?? "").replace(/\s+/g, " ").trim();
+    const capped = flat.length > MAX_LABEL_CHARS ? `${flat.slice(0, MAX_LABEL_CHARS - 1).trimEnd()}…` : flat;
+    return (capped || fallback).replace(/[\\[\]]/g, (c)=>`\\${c}`);
+}
+function markdownDestination(url) {
+    return url.replace(/[()\s<>]/g, (c)=>`%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0")}`);
+}
+/**
+ * Pre-built markdown link for `cite_as`, or null when there is no usable URL.
+ * Only https URLs qualify: the chat renderer drops other schemes.
+ */ function citeAs(label, url, fallbackLabel = "source") {
+    const safe = httpsUrlOrNull(url);
+    if (!safe) return null;
+    return `[${markdownLabel(label, fallbackLabel)}](${markdownDestination(safe)})`;
+}
+
+
 /***/ }),
 
 /***/ 82703:
@@ -32138,7 +32358,7 @@ __webpack_require__.d(__webpack_exports__, {
   IC: () => (/* binding */ withInterruptMarker)
 });
 
-// UNUSED EXPORTS: INTERRUPT_MARKER, MAX_RATE_LIMIT_RETRY_AFTER_MS, RunThreadError, appendHistoryMessage, buildFabricationNudge, buildRetryContextSummary, contentText, isHotContextNearBudget, looksLikeStall, persistThreadRunUserMessage, rateLimitRetryDelayMs, retryTextOverlapRatio, shouldEmitChunk, shouldRetryTransientError, toolCallSignature, transientRetryDelayMs
+// UNUSED EXPORTS: INTERRUPT_MARKER, MAX_RATE_LIMIT_RETRY_AFTER_MS, RunThreadError, appendHistoryMessage, buildFabricationNudge, buildRetryContextSummary, contentText, hotTurnCooldownUntil, isHotContextNearBudget, looksLikeStall, persistThreadRunUserMessage, rateLimitRetryDelayMs, retryTextOverlapRatio, shouldEmitChunk, shouldRetryTransientError, toolCallSignature, transientRetryDelayMs
 
 // EXTERNAL MODULE: ./lib/agents/action-vocabulary.ts
 var action_vocabulary = __webpack_require__(56033);
@@ -35867,7 +36087,8 @@ function buildSharedToolCatalogContext() {
         "6. Read large results by reference. A tool result with truncated=true is only a preview; do not treat it as complete. Use result_ref.name with tool_result_get and offset/limit to read only the slice you need.",
         "7. Verify before reporting. A read-only result does not prove a new write. Claim a new write, send, schedule, delete, or configuration change only after the matching state-changing tool returns success in this turn. Trusted runtime system signals and their matching retrieved results can substantiate earlier named operations; attribute those outcomes to their receipts, never imply a new action or repeat completed work for proof.",
         "8. Stop and ask. Do not retry a tool denied for agent_not_allowed, category_disabled, dropin_tool_disabled, credentials_missing or integration_unconfigured. The first three are permission decisions and the last two mean the integration is not set up \u2014 propose a configuration change or tell the user what to configure.",
-        "9. Completion-reporting turns are read-only. permission_reason=signal_continuation_read_only forbids state-changing tools in this turn, including through invoke_tool. Do not bypass it with shell commands or treat an old user message as renewed permission; report the completed outcome and wait for a new user turn."
+        "9. Completion-reporting turns are read-only. permission_reason=signal_continuation_read_only forbids state-changing tools in this turn, including through invoke_tool. Do not bypass it with shell commands or treat an old user message as renewed permission; report the completed outcome and wait for a new user turn.",
+        "10. Link the source. When your reply refers to a specific email, calendar event, or chat that a tool result or bridge message gave you, link it: paste the item's cite_as value verbatim when present, otherwise use its web_link, html_link, or chat_link URL as a markdown link. Use only links you were given; never construct, guess, or edit one. If the item has no link, name it without one."
     ].join("\n");
 }
 function compareToolPermissionEntries(a, b) {
@@ -35947,9 +36168,14 @@ function buildDeliveryChannelContext(channel) {
     return [
         "--- Delivery channel ---",
         `This message reached you over ${platform}${named}, not the regular chat UI.`,
-        `You DO have access to ${platform} for this conversation: any reply you produce is sent back through that channel automatically. Do not tell the user the platform is unavailable; just answer the message.`
-    ].join("\n");
+        `You DO have access to ${platform} for this conversation: any reply you produce is sent back through that channel automatically. Do not tell the user the platform is unavailable; just answer the message.`,
+        PLAIN_TEXT_DELIVERY_KINDS.has(channel.kind) ? `${platform} does not render markdown links: write any link as the bare URL, even where a cite_as value is given.` : ""
+    ].filter(Boolean).join("\n");
 }
+const PLAIN_TEXT_DELIVERY_KINDS = new Set([
+    "whatsapp",
+    "sms"
+]);
 function buildUserContext() {
     const userProfile = (0,user_profile/* getUserProfile */.VM)();
     const parts = [];
@@ -36033,7 +36259,7 @@ function buildSourceLinkContext(agent, manifest) {
         "--- Citation format ---",
         intro,
         "PRIMARY (inline links): cite by writing a standard markdown link inline: `[short label](https://example.com/path)` or `[file name](/abs/path.ts)` or `[earlier reply](#msg-<id>)`. Wrap the cited PHRASE itself as the link text when natural — `Jade has [ice skating at 16:00](?thread=…&agent=…)` reads better than a trailing `[1]`.",
-        "When a tool result contains a `cite_as` field (delegate_to_agent does, and so do some integrations), paste that exact value somewhere in your reply — it's a pre-built markdown link to the source. Anything you summarize from a delegate or from a web/file tool result MUST carry at least one inline link back to where it came from; a summary with zero links reads as if you made the facts up.",
+        "When a tool result contains a `cite_as` field (delegate_to_agent does, and so do the email and calendar tools), paste that exact value somewhere in your reply — it's a pre-built markdown link to the source. Anything you summarize from a delegate or from a web/file tool result MUST carry at least one inline link back to where it came from; a summary with zero links reads as if you made the facts up.",
         "For web_search / fetch_webpage results, the URL is right there in the tool output — use it: `[headline or short label](https://...)`. For file_read results, link the absolute path: `[filename.ext](/abs/path/filename.ext)`.",
         "FALLBACK (declared refs block): if a source is awkward to cite inline (e.g. you summarized 4 articles in one paragraph), you MAY end your reply with a fenced block exactly like this:",
         "```jarela-references",
@@ -36532,17 +36758,27 @@ const SOURCE_PRODUCING_TOOLS_RESULT = new Set([
     "fetch_webpage",
     "web_fetch"
 ]);
-// Strip query/fragment for URLs and normalize backslashes for paths so a
-// citation that drops `?utm=...` or uses forward slashes on Windows still
-// matches the visited entry. Also fold `~/...` to the resolved home dir
-// so `~/Downloads/x` and `C:\Users\andre\Downloads\x` de-dupe.
+const TRACKING_PARAM_RE = /^(?:utm(?:_.*)?|fbclid|gclid|dclid|msclkid|mc_cid|mc_eid|igshid|ref_src)$/i;
+// Drop tracking params and in-page anchors for URLs and normalize
+// backslashes for paths so a citation that adds `?utm_source=...` or uses
+// forward slashes on Windows still matches the visited entry. Identifying
+// query params (Outlook `?ItemID=`, `watch?v=`) and hash routes (Gmail
+// `#all/<id>`) are kept verbatim: they are case-sensitive and are the only
+// thing that distinguishes two message permalinks. Also fold `~/...` to the
+// resolved home dir so `~/Downloads/x` and `C:\Users\andre\Downloads\x` de-dupe.
 function normalizeSource(raw) {
     const trimmed = raw.trim();
     if (!trimmed) return "";
     if (/^https?:\/\//i.test(trimmed)) {
         try {
             const u = new URL(trimmed);
-            return `${u.protocol}//${u.host}${u.pathname}`.replace(/\/+$/, "").toLowerCase();
+            const base = `${u.protocol}//${u.host}${u.pathname}`.replace(/\/+$/, "").toLowerCase();
+            const params = [
+                ...u.searchParams
+            ].filter(([key])=>!TRACKING_PARAM_RE.test(key)).sort(([a], [b])=>a < b ? -1 : a > b ? 1 : 0);
+            const query = params.length > 0 ? `?${new URLSearchParams(params).toString()}` : "";
+            const hashRoute = u.hash.includes("/") ? u.hash : "";
+            return base + query + hashRoute;
         } catch  {
             return trimmed.toLowerCase();
         }
@@ -36891,15 +37127,8 @@ ${sent}`;
  */ function parseCitationVerdict(text) {
     if (!text) return null;
     const stripped = text.replace(/```(?:json)?\s*/gi, "").replace(/```/g, "").trim();
-    const m = /\{[^]*"claims"[^]*\}/.exec(stripped);
-    if (!m) return null;
-    let parsed;
-    try {
-        parsed = JSON.parse(m[0]);
-    } catch  {
-        return null;
-    }
-    if (!parsed || typeof parsed !== "object") return null;
+    const parsed = findClaimsObject(stripped);
+    if (!parsed) return null;
     const claimsRaw = parsed.claims;
     if (!Array.isArray(claimsRaw)) return null;
     const claims = [];
@@ -36926,6 +37155,41 @@ ${sent}`;
     }
     return claims;
 }
+// Models often wrap the verdict in prose that itself contains braces, so a
+// single greedy `{...}` match can start or end in the wrong place. Try each
+// `{` as a start and parse the balanced object it opens (string-aware).
+function findClaimsObject(text) {
+    for(let start = text.indexOf("{"); start !== -1; start = text.indexOf("{", start + 1)){
+        const end = balancedObjectEnd(text, start);
+        if (end === -1) continue;
+        const candidate = text.slice(start, end + 1);
+        if (!candidate.includes('"claims"')) continue;
+        try {
+            const parsed = JSON.parse(candidate);
+            if (parsed && typeof parsed === "object" && "claims" in parsed) return parsed;
+        } catch  {}
+    }
+    return null;
+}
+function balancedObjectEnd(text, start) {
+    let depth = 0;
+    let inString = false;
+    for(let i = start; i < text.length; i++){
+        const ch = text[i];
+        if (inString) {
+            if (ch === "\\") i++;
+            else if (ch === '"') inString = false;
+        } else if (ch === '"') {
+            inString = true;
+        } else if (ch === "{") {
+            depth++;
+        } else if (ch === "}") {
+            depth--;
+            if (depth === 0) return i;
+        }
+    }
+    return -1;
+}
 function collectStringsFromPayload(payload, out) {
     if (!payload) return;
     if (typeof payload === "string") {
@@ -37089,17 +37353,31 @@ function hotTurnBoundary(threadId, agentCfg, scope, bridgeKey) {
     const boundary = userMessages[userMessages.length - turnLimit];
     return boundary?.seq ?? null;
 }
-async function maybeAutoCompactOversizedThread(agentId, threadId, messageCount, onCompacting, preserveNewestMessages = 0) {
+// The topic-aware boundary keeps the whole active topic hot, so user turns
+// since the pin usually still exceed the limit right after a commit. Without a
+// cooldown every following turn re-runs the topic LLM pass only to land on the
+// same pin. Skip the next half-limit turns (2 rows per turn) before re-checking.
+function hotTurnCooldownUntil(messageCount, hotTurnLimit) {
+    const turnLimit = hotTurnLimit ?? types/* DEFAULT_HOT_TURN_LIMIT */.u_;
+    const skipTurns = Math.max(1, Math.ceil(Math.max(1, turnLimit) / 2));
+    return messageCount + skipTurns * 2 + 1;
+}
+async function maybeAutoCompactOversizedThread(agentId, threadId, onCompacting, preserveNewestMessages = 0) {
     const cap = (0,config/* getConfig */.z)().maxThreadMessages;
     const keepLast = autoCompactionKeepLast(cap);
     const retainedMessages = keepLast + preserveNewestMessages;
     const triggerAt = cap + (cap - keepLast);
-    if (!Number.isFinite(cap) || cap <= 0 || messageCount < triggerAt) return;
+    if (!Number.isFinite(cap) || cap <= 0) return;
+    // Only foreground rows are ever pruned; counting bridge/watcher/scheduled
+    // rows would re-trigger an LLM compaction on every turn of a busy bridge
+    // agent without ever bringing the count back under the cap.
+    const messageCount = (0,threads/* countForegroundThreadMessages */.Tb)(threadId);
+    if (messageCount < triggerAt) return;
     try {
         // A pin that already keeps the hot tier within the retained range must not
         // be pulled back to the cutoff, nor re-summarised by an LLM on every turn.
         const pinSeq = (0,threads/* getThread */.fG)(threadId)?.hot_since_seq ?? null;
-        if (pinSeq !== null && (0,threads/* countThreadMessagesFromSeq */.fW)(threadId, pinSeq) <= retainedMessages) {
+        if (pinSeq !== null && (0,threads/* countForegroundThreadMessages */.Tb)(threadId, pinSeq) <= retainedMessages) {
             (0,threads/* pruneThreadMessages */.vC)(threadId, retainedMessages, pinSeq);
             return;
         }
@@ -37138,7 +37416,6 @@ async function persistThreadRunUserMessage(req) {
     if (!trimmed && !req.attachments?.length) {
         throw new RunThreadError(400, "message required", "message_required");
     }
-    const messageCountBefore = thread.message_count;
     const autoBoundaryScope = req.context_profile?.history_scope ?? (req.user_category === "bridge" ? "bridge" : "foreground");
     const idleMsBefore = isAutoBoundaryEligibleCategory(req.user_category) ? conversationIdleMs(req.thread_id, autoBoundaryScope, req.history_bridge_key ?? undefined) : null;
     const spilledAttachments = req.attachments?.length ? await spillAttachments(req.attachments) : undefined;
@@ -37158,7 +37435,6 @@ async function persistThreadRunUserMessage(req) {
     });
     return {
         attachments: spilledAttachments,
-        messageCountBefore,
         idleMsBefore,
         userMessageId: userMessage.msg_id,
         storedContent: stored
@@ -37305,7 +37581,7 @@ function appendHistoryMessage(history, injected) {
     let toolPermissionMap = baseToolPermissionMap;
     let allowedTools = requestedAllowedTools;
     if (!req._skip_persist_message && isAutoBoundaryEligibleCategory(req.user_category) && !hasPendingQueuedUserMessage(req.thread_id)) {
-        await maybeAutoCompactOversizedThread(agentCfg.id, req.thread_id, req._message_count_before_user ?? thread.message_count, req._onCompacting, req._user_message_persisted ? 2 : 0);
+        await maybeAutoCompactOversizedThread(agentCfg.id, req.thread_id, req._onCompacting, req._user_message_persisted ? 2 : 0);
     }
     // Persist the user turn (including any attachments) before the LLM stream
     // so reload-mid-stream still shows the prompt. The stall-retry path sets
@@ -37347,7 +37623,11 @@ function appendHistoryMessage(history, injected) {
             const locked = !!latestThread && latestThread.message_count < (latestThread.auto_boundary_locked_until_msg_count ?? 0);
             if (!locked) {
                 const boundary = hotTurnBoundary(req.thread_id, agentCfg, autoBoundaryScope);
-                if (boundary !== null) (0,warm_summary_background/* kickBoundaryCompaction */.Wg)(req.thread_id, boundary);
+                if (boundary !== null) {
+                    (0,warm_summary_background/* kickBoundaryCompaction */.Wg)(req.thread_id, boundary, {
+                        autoBoundaryLockedUntilMessageCount: hotTurnCooldownUntil(latestThread?.message_count ?? 0, agentCfg.hot_turn_limit)
+                    });
+                }
             }
         }
     }
@@ -38814,12 +39094,11 @@ function isBasicToolCategory(category) {
 
 // Every caller of moveThreadContextBoundary represents a user-initiated
 // boundary change (drag the line, the manual /compact command, or the agent's
-// compact_context tool acting on the user's say-so) — the
-// auto-detector's own commit (lib/agents/warm-summary-background.ts
-// commitBoundaryCompaction) calls setThreadContextPin directly instead, so
-// it never re-arms this lock. Suppresses the hot-turn-limit compaction in
-// lib/agents/run-thread.ts for the next N eligible turns so a manual
-// choice doesn't get silently re-moved on the very next turn.
+// compact_context tool acting on the user's say-so). Suppresses the
+// hot-turn-limit compaction in lib/agents/run-thread.ts for the next N
+// eligible turns so a manual choice doesn't get silently re-moved on the very
+// next turn. The auto-detector arms a shorter cooldown of its own
+// (hotTurnCooldownUntil) so it doesn't re-run on every turn either.
 // Counted in messages (~2 per turn: one user + one assistant row) since
 // that's what's already on the thread row — no extra query or per-turn
 // write needed to check it.
@@ -40098,6 +40377,13 @@ function readSnapshotSync() {
     try {
         const p = snapshotPath();
         const stat = (0,external_node_fs_.statSync)(p);
+        if (cached?.path === p && cached.mtimeMs === stat.mtimeMs) {
+            return {
+                path: p,
+                snapshot: null,
+                mtimeMs: stat.mtimeMs
+            };
+        }
         const raw = (0,external_node_fs_.readFileSync)(p, "utf8");
         return {
             path: p,
@@ -40862,12 +41148,35 @@ function createRuntimeRequire(anchor) {
 function managedPackagePath(packageName) {
     return (0,node_path__WEBPACK_IMPORTED_MODULE_0__.join)((0,_langchain_packages__WEBPACK_IMPORTED_MODULE_1__/* .getPackagesDir */ .V_)(), "node_modules", packageName);
 }
+function resolveOptionalPackage(packageName) {
+    const managedReq = createRuntimeRequire((0,node_path__WEBPACK_IMPORTED_MODULE_0__.join)((0,_langchain_packages__WEBPACK_IMPORTED_MODULE_1__/* .getPackagesDir */ .V_)(), "_anchor"));
+    try {
+        return {
+            req: managedReq,
+            path: managedReq.resolve(managedPackagePath(packageName))
+        };
+    } catch  {
+    // Workspace builds expose bundled @circuitwall packages from the app root.
+    }
+    if (process.env.JARELA_PACKAGES_DIR?.trim()) return null;
+    if (!packageName.startsWith("@circuitwall/")) return null;
+    const appReq = createRuntimeRequire((0,node_path__WEBPACK_IMPORTED_MODULE_0__.join)(process.cwd(), "package.json"));
+    try {
+        return {
+            req: appReq,
+            path: appReq.resolve(packageName)
+        };
+    } catch  {
+        return null;
+    }
+}
 function loadOptionalPackage(packageName) {
     const override = testOverrides.get(packageName);
     if (override) return override;
+    const resolved = resolveOptionalPackage(packageName);
+    if (!resolved) return null;
     try {
-        const req = createRuntimeRequire((0,node_path__WEBPACK_IMPORTED_MODULE_0__.join)((0,_langchain_packages__WEBPACK_IMPORTED_MODULE_1__/* .getPackagesDir */ .V_)(), "_anchor"));
-        return req(managedPackagePath(packageName));
+        return resolved.req(resolved.path);
     } catch (err) {
         // Keep the optional boundary non-fatal, but leave the actual load failure
         // visible so missing peer dependencies are diagnosable from server logs.
@@ -40899,9 +41208,10 @@ function optionalFunction(packageName, exportName, fallback) {
     };
 }
 function isOptionalPackageInstalled(packageName) {
+    const resolved = resolveOptionalPackage(packageName);
+    if (!resolved) return false;
     try {
-        const req = createRuntimeRequire(join(getPackagesDir(), "_anchor"));
-        req(managedPackagePath(packageName));
+        resolved.req(resolved.path);
         return true;
     } catch (err) {
         console.error(`[optional-package] failed to load ${packageName}: ${err instanceof Error ? err.message : String(err)}`);