@agent-native/core 0.77.16 → 0.77.17

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

@@ -134,8 +134,10 @@ export default runMigrations(
       event_name TEXT NOT NULL,
       user_id TEXT,
       anonymous_id TEXT,
+      user_key TEXT,
       session_id TEXT,
       timestamp TEXT NOT NULL,
+      event_date TEXT,
       received_at TEXT NOT NULL DEFAULT (datetime('now')),
       url TEXT,
       path TEXT,
@@ -219,6 +221,77 @@ export default runMigrations(
       version: 38,
       sql: `SELECT 1`,
     },
+    {
+      version: 39,
+      sql: `ALTER TABLE analytics_events ADD COLUMN IF NOT EXISTS event_date TEXT`,
+    },
+    {
+      version: 40,
+      sql: `ALTER TABLE analytics_events ADD COLUMN IF NOT EXISTS user_key TEXT`,
+    },
+    {
+      version: 41,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_org_event_date_idx; CREATE INDEX CONCURRENTLY analytics_events_org_event_date_idx ON analytics_events (org_id, event_date)`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_org_event_date_idx ON analytics_events (org_id, event_date)`,
+      },
+    },
+    {
+      version: 42,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_org_event_name_date_idx; CREATE INDEX CONCURRENTLY analytics_events_org_event_name_date_idx ON analytics_events (org_id, event_name, event_date)`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_org_event_name_date_idx ON analytics_events (org_id, event_name, event_date)`,
+      },
+    },
+    {
+      version: 43,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_org_date_user_idx; CREATE INDEX CONCURRENTLY analytics_events_org_date_user_idx ON analytics_events (org_id, event_date, user_key)`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_org_date_user_idx ON analytics_events (org_id, event_date, user_key)`,
+      },
+    },
+    {
+      version: 44,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_org_date_template_idx; CREATE INDEX CONCURRENTLY analytics_events_org_date_template_idx ON analytics_events (org_id, event_date, template)`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_org_date_template_idx ON analytics_events (org_id, event_date, template)`,
+      },
+    },
+    {
+      version: 45,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_owner_event_date_idx; CREATE INDEX CONCURRENTLY analytics_events_owner_event_date_idx ON analytics_events (owner_email, event_date) WHERE org_id IS NULL`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_owner_event_date_idx ON analytics_events (owner_email, event_date) WHERE org_id IS NULL`,
+      },
+    },
+    {
+      version: 46,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_owner_event_name_date_idx; CREATE INDEX CONCURRENTLY analytics_events_owner_event_name_date_idx ON analytics_events (owner_email, event_name, event_date) WHERE org_id IS NULL`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_owner_event_name_date_idx ON analytics_events (owner_email, event_name, event_date) WHERE org_id IS NULL`,
+      },
+    },
+    {
+      version: 47,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_owner_date_user_idx; CREATE INDEX CONCURRENTLY analytics_events_owner_date_user_idx ON analytics_events (owner_email, event_date, user_key) WHERE org_id IS NULL`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_owner_date_user_idx ON analytics_events (owner_email, event_date, user_key) WHERE org_id IS NULL`,
+      },
+    },
+    {
+      version: 48,
+      sql: {
+        postgres: `DROP INDEX CONCURRENTLY IF EXISTS analytics_events_owner_date_template_idx; CREATE INDEX CONCURRENTLY analytics_events_owner_date_template_idx ON analytics_events (owner_email, event_date, template) WHERE org_id IS NULL`,
+        sqlite: `CREATE INDEX IF NOT EXISTS analytics_events_owner_date_template_idx ON analytics_events (owner_email, event_date, template) WHERE org_id IS NULL`,
+      },
+    },
+    {
+      version: 49,
+      sql: {
+        postgres: `UPDATE analytics_events SET event_date = COALESCE(NULLIF(event_date, ''), substr(timestamp, 1, 10)), user_key = COALESCE(NULLIF(user_key, ''), NULLIF(user_id, ''), NULLIF(anonymous_id, '')) WHERE (event_date IS NULL OR event_date = '' OR user_key IS NULL OR user_key = '') AND timestamp >= to_char(CURRENT_DATE - INTERVAL '400 days', 'YYYY-MM-DD')`,
+        sqlite: `UPDATE analytics_events SET event_date = COALESCE(NULLIF(event_date, ''), substr(timestamp, 1, 10)), user_key = COALESCE(NULLIF(user_key, ''), NULLIF(user_id, ''), NULLIF(anonymous_id, '')) WHERE (event_date IS NULL OR event_date = '' OR user_key IS NULL OR user_key = '') AND timestamp >= date('now', '-400 days')`,
+      },
+    },
   ],
   { table: "analytics_migrations" },
 );

package/corpus/templates/clips/AGENTS.md

@@ -79,6 +79,11 @@ Detailed media, meeting, dictation, editing, and sharing rules live in
   the Chrome debugger API only on the tab the user launched from, only while a
   recording is active, and returns the same redacted diagnostics shape saved by
   `save-browser-diagnostics`.
+- The Chrome extension also enhances GitHub issue and PR markdown: a narrow
+  `github.com` content script detects Clips `/r/`, `/share/`, and `/embed/`
+  links, then renders the existing `/embed/:id` player in an extension-owned
+  preview iframe so the video is playable without leaving GitHub. Keep this
+  scoped to GitHub unless there is a deliberate permission review.
 - After mutations, rely on the app refresh/polling path; do not invent a second
   sync mechanism.
 

package/corpus/templates/clips/changelog/2026-06-25-github-issue-and-pull-request-pages-can-now-preview-playable.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-25
+---
+
+GitHub issue and pull request pages can now preview playable Clips links when the Chrome extension is installed.

package/corpus/templates/clips/chrome-extension/PERMISSIONS.md

@@ -1,7 +1,7 @@
 # Permissions model
 
-This extension ships **activeTab-only**: it deliberately does **not** request the
-broad `<all_urls>` host permission, and it has **no declarative `content_scripts`**.
+This extension ships **activeTab-only for recording overlays**: it deliberately
+does **not** request the broad `<all_urls>` host permission for recording UI.
 
 ## Why
 
@@ -9,6 +9,11 @@ A declarative content script on `<all_urls>` (and the matching `<all_urls>` host
 permission) triggers Chrome Web Store's **broad host permission in-depth review**,
 which significantly delays publishing and updates. We avoid that.
 
+The only declarative content script is scoped to `https://github.com/*`. It
+looks for Clips links in GitHub issue/PR markdown and replaces them with a
+playable preview iframe owned by the extension. That adds a narrow GitHub host
+disclosure, but does not grant broad access to every page.
+
 ## How the overlay gets on the page
 
 When the user clicks the extension and starts a recording, the background service
@@ -24,6 +29,7 @@ Declared permissions: `activeTab`, `debugger`, `offscreen`, `scripting`,
 `storage`. Host permissions: only the configured Clips app + `forms.agent-native.com`
 
 - `localhost`/`127.0.0.1`.
+- `https://github.com/*` is content-script scoped for link previews only.
 
 ## What this costs
 

package/corpus/templates/clips/chrome-extension/public/manifest.json

@@ -2,8 +2,8 @@
   "manifest_version": 3,
   "name": "Agent-Native Clips",
   "short_name": "Clips",
-  "version": "0.1.3",
-  "description": "Start Clips recordings from Chrome with optional redacted console and network diagnostics.",
+  "version": "0.1.4",
+  "description": "Start Clips recordings from Chrome, capture optional diagnostics, and preview Clips links on GitHub.",
   "minimum_chrome_version": "116",
   "action": {
     "default_title": "Record with Clips",
@@ -25,10 +25,22 @@
     "http://localhost/*",
     "http://127.0.0.1/*"
   ],
+  "content_scripts": [
+    {
+      "matches": ["https://github.com/*"],
+      "js": ["assets/github-preview-content.js"],
+      "run_at": "document_idle",
+      "all_frames": false
+    }
+  ],
   "web_accessible_resources": [
     {
       "resources": ["src/overlay.html", "assets/*", "icons/*"],
       "matches": ["<all_urls>"]
+    },
+    {
+      "resources": ["src/github-preview.html"],
+      "matches": ["https://github.com/*"]
     }
   ],
   "externally_connectable": {

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

@@ -0,0 +1,233 @@
+// GitHub Clips link previews. This is a narrow declarative content script for
+// github.com only; the recording overlay remains activeTab-injected.
+(function clipsGithubPreviewContent() {
+  const ROOT_CLASS = "clips-github-preview";
+  const PROCESSED_ATTR = "data-clips-github-preview";
+  const SOURCE_ATTR = "data-clips-source-url";
+  const EXTENSION_ORIGIN = chrome.runtime.getURL("").replace(/\/$/, "");
+  const CLIPS_HOSTS = new Set(["clips.agent-native.com"]);
+  const LOCAL_HOSTS = new Set(["localhost", "127.0.0.1"]);
+  const ROUTE_SEGMENTS = new Set(["r", "share", "embed"]);
+  const MIN_HEIGHT = 120;
+  const MAX_HEIGHT = 720;
+
+  type ClipsLink = {
+    sourceUrl: string;
+    embedUrl: string;
+    metadataUrl: string;
+    clipId: string;
+    host: string;
+  };
+
+  let scanTimer: ReturnType<typeof setTimeout> | undefined;
+  let frameCounter = 0;
+
+  function isAllowedHost(url: URL): boolean {
+    if (CLIPS_HOSTS.has(url.hostname)) return true;
+    if (LOCAL_HOSTS.has(url.hostname)) return true;
+    return false;
+  }
+
+  function safeTimeParam(value: string | null): string | null {
+    const trimmed = value?.trim();
+    if (!trimmed || trimmed.length > 32) return null;
+    if (/^\d{1,6}(\.\d{1,3})?$/.test(trimmed)) return trimmed;
+    if (/^\d{1,2}:\d{1,2}(:\d{1,2})?$/.test(trimmed)) return trimmed;
+    if (/^(?:\d{1,4}h)?(?:\d{1,4}m)?(?:\d{1,4}s)?$/i.test(trimmed)) {
+      return /\d/.test(trimmed) ? trimmed : null;
+    }
+    return null;
+  }
+
+  function parseClipsLink(raw: string): ClipsLink | null {
+    let parsed: URL;
+    try {
+      parsed = new URL(raw);
+    } catch {
+      return null;
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      return null;
+    }
+    if (!isAllowedHost(parsed)) return null;
+
+    const segments = parsed.pathname.split("/").filter(Boolean);
+    const routeIndex = segments.findIndex((segment) =>
+      ROUTE_SEGMENTS.has(segment),
+    );
+    if (routeIndex === -1) return null;
+
+    const route = segments[routeIndex];
+    const clipId = segments[routeIndex + 1];
+    if (!clipId || clipId === "meeting" || clipId.length > 240) return null;
+    if (route === "share" && clipId === "meeting") return null;
+
+    let decodedClipId = clipId;
+    try {
+      decodedClipId = decodeURIComponent(clipId);
+    } catch {
+      // Keep the raw segment; malformed escaping should not break the scanner.
+    }
+
+    const baseSegments = segments.slice(0, routeIndex);
+    const sourceUrl = new URL(parsed.pathname, parsed.origin);
+    const embedPath = [
+      "",
+      ...baseSegments,
+      "embed",
+      encodeURIComponent(decodedClipId),
+    ].join("/");
+    const embedUrl = new URL(embedPath, parsed.origin);
+    const metadataUrl = new URL(
+      ["", ...baseSegments, "api", "public-recording"].join("/"),
+      parsed.origin,
+    );
+    metadataUrl.searchParams.set("id", decodedClipId);
+
+    const time = safeTimeParam(parsed.searchParams.get("t"));
+    if (time) {
+      sourceUrl.searchParams.set("t", time);
+      embedUrl.searchParams.set("t", time);
+    }
+
+    return {
+      sourceUrl: sourceUrl.toString(),
+      embedUrl: embedUrl.toString(),
+      metadataUrl: metadataUrl.toString(),
+      clipId,
+      host: parsed.host,
+    };
+  }
+
+  function isGitHubMarkdownAnchor(anchor: HTMLAnchorElement): boolean {
+    if (anchor.closest(`.${ROOT_CLASS}`)) return false;
+    return Boolean(
+      anchor.closest(
+        [
+          ".markdown-body",
+          ".comment-body",
+          ".js-comment-body",
+          ".timeline-comment",
+          ".js-issue-body",
+          ".js-pull-request-body",
+        ].join(","),
+      ),
+    );
+  }
+
+  function previewInsertionTarget(anchor: HTMLAnchorElement): HTMLElement {
+    const block = anchor.closest(
+      [
+        "p",
+        "li",
+        "td",
+        "blockquote",
+        "pre",
+        ".markdown-body > div",
+        ".comment-body",
+      ].join(","),
+    );
+    return block instanceof HTMLElement ? block : anchor;
+  }
+
+  function existingPreview(sourceUrl: string): HTMLElement | null {
+    for (const element of document.querySelectorAll<HTMLElement>(
+      `.${ROOT_CLASS}`,
+    )) {
+      if (element.getAttribute(SOURCE_ATTR) === sourceUrl) return element;
+    }
+    return null;
+  }
+
+  function mountPreview(anchor: HTMLAnchorElement, link: ClipsLink): void {
+    if (existingPreview(link.sourceUrl)) {
+      anchor.setAttribute(PROCESSED_ATTR, "mounted");
+      return;
+    }
+
+    const frameId = `clips-github-preview-${++frameCounter}`;
+    const wrapper = document.createElement("div");
+    wrapper.className = ROOT_CLASS;
+    wrapper.id = `${frameId}-wrapper`;
+    wrapper.setAttribute(SOURCE_ATTR, link.sourceUrl);
+    Object.assign(wrapper.style, {
+      display: "block",
+      width: "min(720px, 100%)",
+      maxWidth: "100%",
+      margin: "8px 0 16px",
+      clear: "both",
+    });
+
+    const frame = document.createElement("iframe");
+    frame.id = frameId;
+    frame.title = "Clips preview";
+    frame.allow = "autoplay; fullscreen; picture-in-picture";
+    frame.setAttribute("allowfullscreen", "true");
+    frame.setAttribute("scrolling", "no");
+    frame.referrerPolicy = "no-referrer";
+    Object.assign(frame.style, {
+      display: "block",
+      width: "100%",
+      height: "430px",
+      border: "0",
+      borderRadius: "8px",
+      background: "transparent",
+      overflow: "hidden",
+    });
+
+    const previewUrl = new URL(
+      chrome.runtime.getURL("src/github-preview.html"),
+    );
+    previewUrl.searchParams.set("frameId", frameId);
+    previewUrl.searchParams.set("embedUrl", link.embedUrl);
+    previewUrl.searchParams.set("metadataUrl", link.metadataUrl);
+    previewUrl.searchParams.set("sourceUrl", link.sourceUrl);
+    previewUrl.searchParams.set("clipId", link.clipId);
+    previewUrl.searchParams.set("host", link.host);
+    frame.src = previewUrl.toString();
+
+    wrapper.appendChild(frame);
+    previewInsertionTarget(anchor).after(wrapper);
+    anchor.setAttribute(PROCESSED_ATTR, "mounted");
+  }
+
+  function scan(): void {
+    for (const anchor of document.querySelectorAll<HTMLAnchorElement>(
+      `a[href]:not([${PROCESSED_ATTR}])`,
+    )) {
+      if (!isGitHubMarkdownAnchor(anchor)) continue;
+      const link = parseClipsLink(anchor.href);
+      if (!link) continue;
+      mountPreview(anchor, link);
+    }
+  }
+
+  function scheduleScan(): void {
+    clearTimeout(scanTimer);
+    scanTimer = setTimeout(scan, 120);
+  }
+
+  window.addEventListener("message", (event) => {
+    if (event.origin !== EXTENSION_ORIGIN) return;
+    const data = event.data as
+      | { source?: string; frameId?: string; height?: number }
+      | undefined;
+    if (data?.source !== "clips-github-preview") return;
+    if (!data.frameId || typeof data.height !== "number") return;
+    const frame = document.getElementById(data.frameId);
+    if (!(frame instanceof HTMLIFrameElement)) return;
+    const height = Math.max(
+      MIN_HEIGHT,
+      Math.min(MAX_HEIGHT, Math.ceil(data.height)),
+    );
+    frame.style.height = `${height}px`;
+  });
+
+  const observer = new MutationObserver(scheduleScan);
+  observer.observe(document.documentElement, {
+    childList: true,
+    subtree: true,
+  });
+
+  scan();
+})();

package/corpus/templates/clips/chrome-extension/src/github-preview.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Clips preview</title>
+    <script type="module" src="./github-preview.ts"></script>
+  </head>
+  <body>
+    <main id="root"></main>
+  </body>
+</html>