@agent-native/core 0.180.0-nightly-20260915184036 → 0.180.0

package/corpus/templates/clips/chrome-extension/src/content-script.ts

@@ -22,6 +22,148 @@
   flags.__clipsOverlayHostReady = true;
   let recordingActive = false;
 
+  type InteractionKind = "navigation" | "click" | "input" | "scroll";
+  const HISTORY_NAVIGATION_DEDUPE_MS = 250;
+  const HISTORY_NAVIGATION_WINDOW_MS = 1000;
+  const MAX_HISTORY_NAVIGATION_MESSAGES_PER_WINDOW = 20;
+  const CLICK_INPUT_WINDOW_MS = 1000;
+  const MAX_CLICK_INPUT_MESSAGES_PER_WINDOW = 100;
+  let historyBridgeToken: string | null = null;
+  let historyNavigationWindowStartedAt = 0;
+  let historyNavigationCount = 0;
+  let clickInputWindowStartedAt = 0;
+  let clickInputCount = 0;
+  let lastHistoryNavigation: { url: string; sentAtMs: number } | null = null;
+  const OVERLAY_ROOT_ID = "clips-recorder-overlay-root";
+
+  function resetDiagnosticQuotas(): void {
+    historyNavigationWindowStartedAt = 0;
+    historyNavigationCount = 0;
+    clickInputWindowStartedAt = 0;
+    clickInputCount = 0;
+    lastHistoryNavigation = null;
+  }
+
+  function targetDescriptor(target: EventTarget | null): string | undefined {
+    if (!(target instanceof Element)) return undefined;
+    if (target.closest(`#${OVERLAY_ROOT_ID}`)) return undefined;
+    const element = target.closest(
+      "button,a,input,textarea,select,[role=button]",
+    ) as Element | null;
+    const candidate = element ?? target;
+    const tag = candidate.tagName.toLowerCase();
+    const id = candidate.id;
+    const testId = candidate.getAttribute("data-testid");
+    const name = candidate.getAttribute("name");
+    const part = [id, testId, name].find((value): value is string => {
+      if (!value || value.length > 80) return false;
+      return /^[A-Za-z0-9_.:-]+$/.test(value);
+    });
+    return `${tag}${part ? `#${part}` : ""}`.slice(0, 200);
+  }
+
+  function sendDiagnosticInteraction(
+    kind: InteractionKind,
+    target: EventTarget | null = null,
+    url?: string,
+  ): void {
+    if (!recordingActive) return;
+    if (kind === "click" || kind === "input") {
+      const now = Date.now();
+      if (now - clickInputWindowStartedAt >= CLICK_INPUT_WINDOW_MS) {
+        clickInputWindowStartedAt = now;
+        clickInputCount = 0;
+      }
+      if (clickInputCount >= MAX_CLICK_INPUT_MESSAGES_PER_WINDOW) return;
+      clickInputCount += 1;
+    }
+    try {
+      chrome.runtime.sendMessage(
+        {
+          type: "CLIPS_DIAGNOSTIC_INTERACTION",
+          kind,
+          target: targetDescriptor(target),
+          ...(url ? { url } : {}),
+        },
+        () => void chrome.runtime.lastError,
+      );
+      // coercion-ok: the extension context can disappear after page unload; capture is best-effort
+    } catch {
+      /* background unavailable */
+    }
+  }
+
+  function sendDiagnosticNavigation(url: string): void {
+    if (!recordingActive) return;
+    const now = Date.now();
+    if (
+      lastHistoryNavigation?.url === url &&
+      now - lastHistoryNavigation.sentAtMs < HISTORY_NAVIGATION_DEDUPE_MS
+    ) {
+      return;
+    }
+    if (
+      now - historyNavigationWindowStartedAt >=
+      HISTORY_NAVIGATION_WINDOW_MS
+    ) {
+      historyNavigationWindowStartedAt = now;
+      historyNavigationCount = 0;
+    }
+    if (historyNavigationCount >= MAX_HISTORY_NAVIGATION_MESSAGES_PER_WINDOW) {
+      return;
+    }
+    historyNavigationCount += 1;
+    lastHistoryNavigation = { url, sentAtMs: now };
+    sendDiagnosticInteraction("navigation", null, url);
+  }
+
+  window.addEventListener("message", (event) => {
+    if (event.source !== window) return;
+    const data = event.data as
+      | { source?: unknown; kind?: unknown; token?: unknown; url?: unknown }
+      | undefined;
+    if (
+      data?.source === "clips-diagnostic-history" &&
+      data.kind === "token" &&
+      typeof data.token === "string"
+    ) {
+      historyBridgeToken = data.token;
+      return;
+    }
+    if (!recordingActive) return;
+    if (
+      data?.source !== "clips-diagnostic-history" ||
+      data.kind !== "navigation" ||
+      data.token !== historyBridgeToken ||
+      typeof data.url !== "string"
+    ) {
+      return;
+    }
+    sendDiagnosticNavigation(data.url);
+  });
+  window.postMessage(
+    { source: "clips-diagnostic-history", kind: "request-token" },
+    "*",
+  );
+
+  let lastScrollAt = 0;
+  const onClick = (event: MouseEvent) =>
+    sendDiagnosticInteraction("click", event.target);
+  const onInput = (event: Event) =>
+    sendDiagnosticInteraction("input", event.target);
+  const onScroll = (event: Event) => {
+    const now = Date.now();
+    if (now - lastScrollAt < 250) return;
+    lastScrollAt = now;
+    sendDiagnosticInteraction("scroll", event.target);
+  };
+  const onNavigation = () => sendDiagnosticNavigation(window.location.href);
+  document.addEventListener("click", onClick, true);
+  document.addEventListener("input", onInput, true);
+  document.addEventListener("scroll", onScroll, true);
+  window.addEventListener("popstate", onNavigation);
+  window.addEventListener("hashchange", onNavigation);
+
   function errorPayload(error: unknown): {
     name: string;
     message: string;
@@ -82,7 +224,12 @@
   try {
     chrome.storage.onChanged.addListener((changes, areaName) => {
       if (areaName !== "local" || !changes.clipsRecordingActive) return;
-      recordingActive = changes.clipsRecordingActive.newValue === true;
+      const nextRecordingActive =
+        changes.clipsRecordingActive.newValue === true;
+      if (nextRecordingActive && !recordingActive) {
+        resetDiagnosticQuotas();
+      }
+      recordingActive = nextRecordingActive;
     });
   } catch {
     /* storage unavailable */
@@ -354,8 +501,15 @@
     try {
       chrome.storage.local.get("clipsRecordingActive", (value) => {
         if (chrome.runtime.lastError) return;
-        recordingActive = value?.clipsRecordingActive === true;
-        if (recordingActive) requestState();
+        const nextRecordingActive = value?.clipsRecordingActive === true;
+        if (nextRecordingActive && !recordingActive) {
+          resetDiagnosticQuotas();
+        }
+        recordingActive = nextRecordingActive;
+        if (recordingActive) {
+          sendDiagnosticNavigation(window.location.href);
+          requestState();
+        }
       });
     } catch {
       /* ignore */
@@ -554,9 +708,12 @@
     });
   }
 
-  function reconcile(parts: OverlayPart[]): void {
+  function reconcile(parts: OverlayPart[], resetQuotas = false): void {
     console.log("[clips-cs] reconcile parts:", parts, "on", location.href);
     const wanted = new Set(parts.filter((p) => ALL_PARTS.includes(p)));
+    const enteringRecording =
+      wanted.has("toolbar") && !lastWantedParts.has("toolbar");
+    if (resetQuotas || enteringRecording) resetDiagnosticQuotas();
     const enteringCameraCountdown =
       wanted.has("countdown") &&
       wanted.has("bubble") &&
@@ -614,7 +771,11 @@
     const type = (message as { type?: unknown }).type;
     if (type === "CLIPS_OVERLAY_MOUNT") {
       const parts = (message as { parts?: unknown }).parts;
-      reconcile(Array.isArray(parts) ? (parts as OverlayPart[]) : []);
+      reconcile(
+        Array.isArray(parts) ? (parts as OverlayPart[]) : [],
+        (message as { resetDiagnosticQuotas?: unknown })
+          .resetDiagnosticQuotas === true,
+      );
     } else if (type === "CLIPS_OVERLAY_UNMOUNT") {
       reconcile([]);
     }

package/corpus/templates/clips/chrome-extension/vite.config.ts

@@ -68,6 +68,10 @@ export default defineConfig({
     rollupOptions: {
       input: {
         background: resolve(root, "src/background.ts"),
+        "content-history-bridge": resolve(
+          root,
+          "src/content-history-bridge.ts",
+        ),
         "content-script": resolve(root, "src/content-script.ts"),
         "github-preview-content": resolve(
           root,

package/corpus/templates/clips/server/db/schema.ts

@@ -305,6 +305,9 @@ export const recordingBrowserDiagnostics = table(
     endedAt: text("ended_at").notNull(),
     consoleLogsJson: text("console_logs_json").notNull().default("[]"),
     networkRequestsJson: text("network_requests_json").notNull().default("[]"),
+    interactionEventsJson: text("interaction_events_json")
+      .notNull()
+      .default("[]"),
     redactionVersion: integer("redaction_version").notNull().default(1),
     createdAt: text("created_at").notNull().default(now()),
     updatedAt: text("updated_at").notNull().default(now()),

package/corpus/templates/clips/server/lib/public-agent-context.ts

@@ -21,7 +21,9 @@ import {
 } from "../../shared/agent-context.js";
 import {
   parseBrowserDiagnosticsRow,
+  sanitizeBrowserDiagnosticNavigationUrl,
   type BrowserDiagnosticsData,
+  type BrowserDiagnosticTimelineEvent,
 } from "../../shared/browser-diagnostics.js";
 import {
   isLoomEmbedBackedRecording,
@@ -414,6 +416,7 @@ export async function loadAgentBugReport(
 // the true total counts.
 const MAX_PUBLIC_AGENT_CONSOLE_LOGS = 100;
 const MAX_PUBLIC_AGENT_NETWORK_REQUESTS = 100;
+const MAX_PUBLIC_AGENT_TIMELINE_EVENTS = 100;
 // Curated warn/error highlights and failed-request highlights.
 const MAX_PUBLIC_AGENT_DIAGNOSTIC_ISSUES = 20;
 
@@ -443,6 +446,37 @@ function toPublicNetworkEntry(
   };
 }
 
+function toPublicTimelineEntry(entry: BrowserDiagnosticTimelineEvent) {
+  const base = {
+    timestampMs: entry.elapsedMs,
+    kind: entry.kind,
+  };
+  if (entry.kind === "console") {
+    return {
+      ...base,
+      level: entry.level,
+      message: entry.message,
+    };
+  }
+  if (entry.kind === "network") {
+    return {
+      ...base,
+      phase: entry.phase,
+      type: entry.type,
+      method: entry.method,
+      url: entry.url,
+      status: entry.status ?? null,
+      error: entry.error ?? null,
+      durationMs: entry.durationMs ?? null,
+    };
+  }
+  return {
+    ...base,
+    target: entry.target ?? null,
+    url: entry.url ? sanitizeBrowserDiagnosticNavigationUrl(entry.url) : null,
+  };
+}
+
 function isFailedNetworkRequest(
   entry: BrowserDiagnosticsData["networkRequests"][number],
 ): boolean {
@@ -474,13 +508,17 @@ function compactBrowserDiagnostics(diagnostics: BrowserDiagnosticsData | null) {
     .filter(isFailedNetworkRequest)
     .slice(-MAX_PUBLIC_AGENT_DIAGNOSTIC_ISSUES)
     .map(toPublicNetworkEntry);
+  const timeline = (diagnostics.timeline ?? [])
+    .slice(-MAX_PUBLIC_AGENT_TIMELINE_EVENTS)
+    .map(toPublicTimelineEntry);
   return {
     summary: diagnostics.summary,
+    timeline,
     consoleLogs,
     consoleIssues,
     networkRequests,
     failedNetworkRequests,
-    note: "Console logs include all levels (debug/log/info/warn/error). Network requests include method, sanitized URL (path kept, query values redacted), status, and duration. Diagnostics are bounded; the recording's own page URL, request headers, request/response bodies, and cookies are omitted.",
+    note: "Timeline entries are relative to recording start and include redacted navigation, click/input targets, console events, and request/response markers. Diagnostics are bounded; the recording's own page URL, request headers, request/response bodies, and cookies are omitted.",
   };
 }
 
@@ -613,7 +651,7 @@ export function buildPublicAgentContext({
       : []),
     ...(browserDiagnostics
       ? [
-          "Use browserDiagnostics.consoleLogs for the redacted console stream (all levels: debug/log/info/warn/error) and browserDiagnostics.networkRequests for the fetch/XHR requests (method, sanitized URL, status, duration) captured during the recording. browserDiagnostics.consoleIssues highlights just the warnings/errors, and browserDiagnostics.failedNetworkRequests highlights failed requests.",
+          "Use browserDiagnostics.timeline for the bounded, relative event sequence: navigation, click/input targets, console events, and request/response markers. Use browserDiagnostics.consoleLogs and browserDiagnostics.networkRequests for the full redacted streams; consoleIssues and failedNetworkRequests are curated failure highlights.",
         ]
       : []),
     ...(!clipIsReady

package/corpus/templates/clips/server/plugins/db.ts

@@ -1245,6 +1245,11 @@ export const migrations = runMigrations(
       CREATE INDEX IF NOT EXISTS clips_intake_sessions_expires_idx
         ON clips_intake_sessions (status, expires_at)`,
     },
+    {
+      version: 73,
+      name: "recording-browser-diagnostics-interaction-events",
+      sql: `ALTER TABLE recording_browser_diagnostics ADD COLUMN IF NOT EXISTS interaction_events_json TEXT NOT NULL DEFAULT '[]'`,
+    },
   ],
   { table: "clips_migrations" },
 );

package/corpus/templates/clips/shared/browser-diagnostics.ts

@@ -1,6 +1,12 @@
 export const MAX_BROWSER_DIAGNOSTIC_CONSOLE_LOGS = 400;
 export const MAX_BROWSER_DIAGNOSTIC_NETWORK_REQUESTS = 400;
+export const MAX_BROWSER_DIAGNOSTIC_INTERACTION_EVENTS = 800;
+export const MAX_BROWSER_DIAGNOSTIC_TIMELINE_EVENTS =
+  MAX_BROWSER_DIAGNOSTIC_CONSOLE_LOGS +
+  MAX_BROWSER_DIAGNOSTIC_NETWORK_REQUESTS * 2 +
+  MAX_BROWSER_DIAGNOSTIC_INTERACTION_EVENTS;
 export const MAX_BROWSER_DIAGNOSTIC_MESSAGE_LENGTH = 2_000;
+export const MAX_BROWSER_DIAGNOSTIC_TARGET_LENGTH = 200;
 export const MAX_BROWSER_DIAGNOSTIC_URL_LENGTH = 1_000;
 
 const SECRET_KEY_FRAGMENT =
@@ -40,6 +46,29 @@ export function redactBrowserDiagnosticString(
     : redacted;
 }
 
+export function sanitizeBrowserDiagnosticNavigationUrl(raw: string): string {
+  const redacted = redactBrowserDiagnosticString(raw, {
+    redactQueryValues: true,
+  });
+  try {
+    const parsed = new URL(redacted, "https://clips.local");
+    parsed.username = "";
+    parsed.password = "";
+    parsed.hash = "";
+    const params = new URLSearchParams();
+    for (const key of parsed.searchParams.keys()) {
+      params.set(key, "<redacted>");
+    }
+    parsed.search = params.toString();
+    return `${parsed.pathname}${parsed.search}`.slice(
+      0,
+      MAX_BROWSER_DIAGNOSTIC_URL_LENGTH,
+    );
+  } catch {
+    return "<redacted>";
+  }
+}
+
 export type BrowserDiagnosticConsoleLevel =
   | "debug"
   | "log"
@@ -68,6 +97,50 @@ export interface BrowserDiagnosticNetworkRequest {
   error?: string;
 }
 
+export type BrowserDiagnosticInteractionKind =
+  | "navigation"
+  | "click"
+  | "input"
+  | "scroll";
+
+export interface BrowserDiagnosticInteractionEvent {
+  timestampMs: number;
+  elapsedMs: number;
+  kind: BrowserDiagnosticInteractionKind;
+  target?: string;
+  url?: string;
+}
+
+type BrowserDiagnosticTimelineBase = Pick<
+  BrowserDiagnosticInteractionEvent,
+  "timestampMs" | "elapsedMs"
+>;
+
+export type BrowserDiagnosticTimelineEvent =
+  | (BrowserDiagnosticTimelineBase & {
+      kind: BrowserDiagnosticInteractionKind;
+      target?: string;
+      url?: string;
+    })
+  | (BrowserDiagnosticTimelineBase & {
+      kind: "console";
+      level: BrowserDiagnosticConsoleLevel;
+      message: string;
+      stack?: string;
+    })
+  | (BrowserDiagnosticTimelineBase & {
+      kind: "network";
+      phase: "request" | "response";
+      type: BrowserDiagnosticNetworkRequest["type"];
+      method: string;
+      url: string;
+      status?: number;
+      statusText?: string;
+      ok?: boolean;
+      durationMs?: number;
+      error?: string;
+    });
+
 export interface BrowserDiagnosticsSnapshot {
   pageUrl: string | null;
   userAgent: string | null;
@@ -75,6 +148,7 @@ export interface BrowserDiagnosticsSnapshot {
   endedAt: string;
   consoleLogs: BrowserDiagnosticConsoleLog[];
   networkRequests: BrowserDiagnosticNetworkRequest[];
+  interactionEvents?: BrowserDiagnosticInteractionEvent[];
 }
 
 export interface BrowserDiagnosticsSummary {
@@ -88,6 +162,7 @@ export interface BrowserDiagnosticsSummary {
 
 export interface BrowserDiagnosticsData extends BrowserDiagnosticsSnapshot {
   summary: BrowserDiagnosticsSummary;
+  timeline?: BrowserDiagnosticTimelineEvent[];
 }
 
 function safeArray(value: string | null | undefined): unknown[] {
@@ -176,6 +251,93 @@ export function normalizeBrowserDiagnosticNetworkRequest(
   };
 }
 
+export function normalizeBrowserDiagnosticInteractionEvent(
+  value: unknown,
+): BrowserDiagnosticInteractionEvent | null {
+  if (!value || typeof value !== "object") return null;
+  const entry = value as Record<string, unknown>;
+  const timestampMs = safeNumber(entry.timestampMs);
+  const elapsedMs = safeNumber(entry.elapsedMs);
+  const kind =
+    entry.kind === "navigation" ||
+    entry.kind === "click" ||
+    entry.kind === "input" ||
+    entry.kind === "scroll"
+      ? entry.kind
+      : null;
+  if (timestampMs === null || elapsedMs === null || !kind) return null;
+  const target = safeString(entry.target, MAX_BROWSER_DIAGNOSTIC_TARGET_LENGTH);
+  const rawUrl = safeString(entry.url, MAX_BROWSER_DIAGNOSTIC_URL_LENGTH);
+  const url = rawUrl ? sanitizeBrowserDiagnosticNavigationUrl(rawUrl) : null;
+  return {
+    timestampMs,
+    elapsedMs,
+    kind,
+    ...(target ? { target } : {}),
+    ...(url ? { url } : {}),
+  };
+}
+
+export function buildBrowserDiagnosticTimeline({
+  consoleLogs,
+  networkRequests,
+  interactionEvents = [],
+}: Pick<
+  BrowserDiagnosticsSnapshot,
+  "consoleLogs" | "networkRequests" | "interactionEvents"
+>): BrowserDiagnosticTimelineEvent[] {
+  const entries: Array<{
+    event: BrowserDiagnosticTimelineEvent;
+    order: number;
+  }> = [];
+  let order = 0;
+  const add = (event: BrowserDiagnosticTimelineEvent) => {
+    entries.push({ event, order: order++ });
+  };
+
+  for (const event of interactionEvents) add(event);
+  for (const entry of consoleLogs) {
+    add({
+      timestampMs: entry.timestampMs,
+      elapsedMs: entry.elapsedMs,
+      kind: "console",
+      level: entry.level,
+      message: entry.message,
+      ...(entry.stack ? { stack: entry.stack } : {}),
+    });
+  }
+  for (const entry of networkRequests) {
+    add({
+      timestampMs: entry.timestampMs,
+      elapsedMs: entry.elapsedMs,
+      kind: "network",
+      phase: "request",
+      type: entry.type,
+      method: entry.method,
+      url: entry.url,
+    });
+    add({
+      timestampMs: entry.timestampMs + entry.durationMs,
+      elapsedMs: entry.elapsedMs + entry.durationMs,
+      kind: "network",
+      phase: "response",
+      type: entry.type,
+      method: entry.method,
+      url: entry.url,
+      ...(typeof entry.status === "number" ? { status: entry.status } : {}),
+      ...(entry.statusText ? { statusText: entry.statusText } : {}),
+      ...(typeof entry.ok === "boolean" ? { ok: entry.ok } : {}),
+      durationMs: entry.durationMs,
+      ...(entry.error ? { error: entry.error } : {}),
+    });
+  }
+
+  return entries
+    .sort((a, b) => a.event.elapsedMs - b.event.elapsedMs || a.order - b.order)
+    .slice(0, MAX_BROWSER_DIAGNOSTIC_TIMELINE_EVENTS)
+    .map(({ event }) => event);
+}
+
 export function summarizeBrowserDiagnostics(
   snapshot: Pick<
     BrowserDiagnosticsSnapshot,
@@ -209,6 +371,7 @@ export function parseBrowserDiagnosticsRow(
         endedAt?: string | null;
         consoleLogsJson?: string | null;
         networkRequestsJson?: string | null;
+        interactionEventsJson?: string | null;
       }
     | null
     | undefined,
@@ -222,6 +385,12 @@ export function parseBrowserDiagnosticsRow(
     .map(normalizeBrowserDiagnosticNetworkRequest)
     .filter((entry): entry is BrowserDiagnosticNetworkRequest => Boolean(entry))
     .slice(0, MAX_BROWSER_DIAGNOSTIC_NETWORK_REQUESTS);
+  const interactionEvents = safeArray(row.interactionEventsJson)
+    .map(normalizeBrowserDiagnosticInteractionEvent)
+    .filter((entry): entry is BrowserDiagnosticInteractionEvent =>
+      Boolean(entry),
+    )
+    .slice(0, MAX_BROWSER_DIAGNOSTIC_INTERACTION_EVENTS);
   const snapshot: BrowserDiagnosticsSnapshot = {
     pageUrl: row.pageUrl ?? null,
     userAgent: row.userAgent ?? null,
@@ -229,9 +398,11 @@ export function parseBrowserDiagnosticsRow(
     endedAt: row.endedAt ?? "",
     consoleLogs,
     networkRequests,
+    interactionEvents,
   };
   return {
     ...snapshot,
     summary: summarizeBrowserDiagnostics(snapshot),
+    timeline: buildBrowserDiagnosticTimeline(snapshot),
   };
 }

package/corpus/templates/content/.agents/skills/content/SKILL.md

@@ -33,8 +33,10 @@ actions, and local folders that sync into the same collection model.
   `share-local-file-document`, `list-local-component-files`, and
   `write-local-component-file`.
 - Use `pull-document` or `get-document` before editing a page. Use
-  `edit-document` for precise find/replace changes and `update-document` for
-  full rewrites or new content.
+  `edit-document` for revision-guarded body changes. When `get-document`
+  returns a literally empty body, initialize it with `initializeContent`, the
+  returned `baseRevision`, and a stable `idempotencyKey`. Browser-owned full
+  rewrites and metadata changes use `update-document`.
 - Use `list-documents` or `search-documents` to find an existing collection by
   its exact title, then inspect it with `get-content-database` before creating
   or submitting anything. Do not create a second collection when the canonical

package/corpus/templates/content/.agents/skills/document-editing/SKILL.md

@@ -99,9 +99,16 @@ pnpm action edit-document --id abc123 --find "delete me" --replace ""
 pnpm action edit-document --id abc123 --edits '[{"find":"old","replace":"new"},{"find":"also old","replace":"also new"}]'
 ```
 
+External MCP, WebMCP, tool, and A2A callers first read the document, then pass
+its `baseRevision` and one stable `idempotencyKey`. When the returned body is
+literally empty, pass non-whitespace `initializeContent` instead of `find` or `edits`.
+Initialization rejects whitespace-only and all other nonempty bodies, preserves
+the Markdown bytes exactly, and safely replays an identical retry.
+
 ### update-document
 
-Update an existing document. Use for **full rewrites or new content**, not for small changes (use `edit-document` instead).
+Update an existing document's metadata or browser-owned content. External
+callers use the revisioned `edit-document` protocol for every body change.
 
 ```bash
 pnpm action update-document --id abc123 --title "New Title"

package/corpus/templates/content/AGENTS.md

@@ -25,10 +25,9 @@ Read the relevant skill before deeper work:
   and access checks are preserved. Never use `curl`, raw HTTP requests, or
   `db-exec` with raw SQL for document operations.
 - Call these actions directly; `ask_app` only delegates to Content's agent.
-- The editor uses live Yjs collaboration — raw SQL writes to `documents` won't
-  appear in an open editor. Always use `edit-document` or `update-document`,
-  and prefer `edit-document` for small changes (it sends only the changed text
-  and syncs live via CRDT instead of regenerating the whole document).
+- The live Yjs editor requires actions for body writes. External agents use
+  revisioned `edit-document`, with `initializeContent` only for an empty body.
+  Browser full rewrites use `update-document`.
 - Preserve user-authored content. Prefer targeted edits over wholesale rewrites
   unless requested.
 - `create-document`, `update-document`, and `delete-document` already signal
@@ -80,8 +79,8 @@ Read the relevant skill before deeper work:
 | `get-blocks-field-word-count` | Count one exact Blocks field; omit `propertyId` for the primary Content body |
 | `create-document` | Create a page, optionally under a parent |
 | `resolve-content-landing` | Restore the caller's last authorized page |
-| `edit-document` | Find/replace edit — preferred for small changes |
-| `update-document` | Full rewrite of title, content, or description |
+| `edit-document` | Revisioned find/replace, or initialize an empty body |
+| `update-document` | Metadata or browser-owned full rewrite |
 | `delete-document` | Move a page and its children to Trash |
 | `list-content-database-blocks` | List stable blocks and revisions in one exact collection row/property |
 | `mutate-content-database-block` | Insert, update, upsert, delete, or reorder one supported stable block |

package/corpus/templates/content/CHANGELOG.md

@@ -5,14 +5,34 @@ time from the command menu (Cmd+K → "What's new").
 
 ## 2026-09-14
 
+### Improved
+
+- Search is now available from the Content sidebar, with clearer date filters and keyboard-friendly calendar navigation.
+
 ### Fixed
 
+- Pages created in agent conversations now appear in navigation and open when they are ready.
+- Cmd+K now opens the command menu while writing in a page.
 - The block drag-handle menu now always opens beside the block instead of sometimes jumping to the corner of the window.
 - Pasting a checklist from Notion or GitHub now keeps its checkboxes instead of turning into plain bullets.
 - Asking the agent about Notion no longer reports "not connected" when the Notion MCP server is connected — it now names the account connection and the MCP connection separately.
 
+## 2026-09-13
+
+### Fixed
+
+- Suggestion previews and highlights stay aligned when editing text near lists.
+
 ## 2026-09-12
 
+### Improved
+
+- Search with quoted phrases, exclusions, OR, and intitle: operators, search all workspaces, pick a modified date from the calendar, and see snippets anchored at the matching sentence deep inside long pages.
+
+### Fixed
+
+- Setting up Notion from a document now opens the Integrations settings, where Notion can actually be connected.
+
 ### Changed
 
 - Databases are now called **collections** across Content — same pages, views, and sharing, friendlier name.
@@ -29,6 +49,10 @@ time from the command menu (Cmd+K → "What's new").
 
 - Connected agents can set up ordinary databases, configure fields and table views, and recover them from Trash with verified results.
 
+### Improved
+
+- Search pages and databases with scoped filters, result previews, and keyboard navigation across result pages.
+
 ### Fixed
 
 - Sidebar Search opens the command picker, icon controls have accessible names, and the sidebar can be resized with the keyboard.