Merge remote-tracking branch 'origin' into shivansh/unit-ui-hint

Author: shivansh

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/fern-check.yml

@@ -20,6 +20,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Build Navigation
         run: |

.github/workflows/preview-docs.yml

@@ -22,6 +22,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Install Fern
         run: npm install -g fern-api

.github/workflows/publish-docs.yml

@@ -21,6 +21,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Download Fern
         run: npm install -g fern-api

.github/workflows/publish-typescript.yml

@@ -28,6 +28,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Build Navigation
         run: |

changelog.py

@@ -18,7 +18,7 @@ def main(vrn, d):
     print('Sending request to LLM.')
     l = llm_client.get_response(p)
     log_file = f"./fern/apis/{vrn}/changelog/{d}.md"
-    if (l):
+    if (l) and 'Error' not in l.partition('\n')[0]:
         with open(log_file, 'w', encoding="utf-8") as outfile:
             outfile.write(llm_client.get_lines_between_tags(l, 'changelog'))
             print(f"Wrote log to {log_file}.")

custom-implementation/src/components/search.tsx

@@ -0,0 +1,38 @@
+export const Search = () => {
+  return (
+    <button
+      id="fern-search-button"
+      className="fern-search-bar w-full"
+      style={{ marginBottom: '8px' }}
+      onClick={() => {
+        if ((window as any).plugSDK) {
+          (window as any).plugSDK.toggleSearchAgent()
+        }
+      }}>
+      <span className="search-placeholder">
+        <svg
+          width="1.5em"
+          height="1.5em"
+          viewBox="0 0 24 24"
+          strokeWidth="1.5"
+          fill="none"
+          xmlns="http://www.w3.org/2000/svg"
+          color="currentColor"
+          className="size-icon-md">
+          <path
+            d="M17 17L21 21"
+            stroke="currentColor"
+            strokeLinecap="round"
+            strokeLinejoin="round"></path>
+          <path
+            d="M3 11C3 15.4183 6.58172 19 11 19C13.213 19 15.2161 18.1015 16.6644 16.6493C18.1077 15.2022 19 13.2053 19 11C19 6.58172 15.4183 3 11 3C6.58172 3 3 6.58172 3 11Z"
+            stroke="currentColor"
+            strokeLinecap="round"
+            strokeLinejoin="round"></path>
+        </svg>
+        <span>Search...</span>
+      </span>
+      <kbd className="keyboard-shortcut-hint">/</kbd>
+    </button>
+  )
+}

custom-implementation/src/main.tsx

@@ -7,6 +7,8 @@ import React from 'react'
 
 import Header from './components/header'
 import Footer from './components/footer'
+
+import { Search } from './components/search'
 import { ThemeSwitch } from './components/theme-switch'
 
 import { getPageData } from './modules/sanity/utils'
@@ -22,16 +24,28 @@ const render = async () => {
    */
 
   const data = await getPageData()
+
   const sidenav = document.querySelector('button.fern-search-bar')
     ?.parentElement as HTMLElement
 
   const theme = document.getElementsByTagName('html')[0].getAttribute('class')
 
-  if (!document.getElementById('theme-switch')) {
+  if (!document.getElementById('sidenav-header-wrapper')) {
+    const sidenavHeaderWrapper = document.createElement('div')
+    sidenavHeaderWrapper.setAttribute('id', 'sidenav-header-wrapper')
+    sidenav.appendChild(sidenavHeaderWrapper)
+
+    const search = document.createElement('div')
+    search.setAttribute('id', 'search-component')
+    sidenavHeaderWrapper.appendChild(search)
+    ReactDOM.render(React.createElement(Search), search)
+
     const wrapper = document.createElement('div')
     wrapper.setAttribute('id', 'theme-switch')
-    sidenav.appendChild(wrapper)
+    sidenavHeaderWrapper.appendChild(wrapper)
     ReactDOM.render(React.createElement(ThemeSwitch), wrapper)
+
+    sidenav.replaceWith(sidenavHeaderWrapper)
   }
 
   const fernHeaderId = document.getElementById(FERN_CONTENT_WRAPPER_ID)
@@ -92,11 +106,46 @@ const render = async () => {
       if (footer) footer.style.display = 'block'
     },
   )
+
+  // Add Plug component directly to body
+  if (!document.getElementById('plug-platform')) {
+    const plugScript = document.createElement('script')
+    plugScript.setAttribute('type', 'text/javascript')
+    plugScript.setAttribute('id', 'plug-platform')
+    plugScript.setAttribute('src', 'https://plug-platform.devrev.ai/static/plug.js')
+    document.body.appendChild(plugScript)
+    
+    // Initialize Plug SDK after script loads
+    plugScript.onload = () => {
+      if ((window as any).plugSDK) {
+        (window as any).plugSDK?.init?.({
+          app_id: data?.plug?.id,
+          enable_session_recording: true,
+        });
+        
+        // Wait for the widget to be ready before adding event listeners
+        (window as any).plugSDK.onEvent((payload: any) => {
+          if(payload.type === "ON_PLUG_WIDGET_READY") {
+            // Initialize search agent after widget is ready
+            (window as any).plugSDK.initSearchAgent();
+            
+            // Add keyboard shortcut for search agent
+            document.addEventListener("keydown", function(event) {
+              // Check if event.key is defined before accessing it
+              if (event && event.key === "/") {
+                event.preventDefault();
+                (window as any).plugSDK.toggleSearchAgent();
+              }
+            });
+          }
+        }); 
+      }
+    }
+  }
 }
 
 let observations = 0
 document.addEventListener('DOMContentLoaded', async () => {
-  console.log('DOMContentLoaded')
   await render()
   new MutationObserver(async (e, o) => {
     await render()

custom-implementation/src/modules/sanity/utils.ts

@@ -15,6 +15,7 @@ export const SANITY_TYPES = {
 export const getPageData = async (): Promise<{
   header: object
   footer: object
+  plug: { id: string }
 }> => {
   const header = await CLIENT.fetch(
     `*[_type == 'headerV2' && slug.current == 'developer']{
@@ -28,5 +29,11 @@ export const getPageData = async (): Promise<{
       }[0]`,
   )
 
-  return { header, footer }
+  const plug = await CLIENT.fetch(
+    `*[_type == 'externalLink' && slug.current == 'devrev-plug-app-id']{
+         "id": href
+      }[0]`,
+  )
+
+  return { header, footer, plug }
 }

fern/apis/beta/changelog/2025-05-19.md

@@ -0,0 +1,78 @@
+## New Endpoints
+
+### Artifacts
+- [`/artifacts.versions.delete`](/beta/api-reference/artifacts/hard-delete-version): Delete an artifact version
+
+### Brands
+- [`/brands.create`](/beta/api-reference/brands/create): Create a new brand
+- [`/brands.delete`](/beta/api-reference/brands/delete): Delete an existing brand
+- [`/brands.get`](/beta/api-reference/brands/get-post): Get the information for a brand
+- [`/brands.list`](/beta/api-reference/brands/list-post): List brands matching a given filter
+- [`/brands.update`](/beta/api-reference/brands/update): Update an existing brand
+
+### Links
+- [`/links.replace`](/beta/api-reference/links/replace): Replace a link
+
+### Metrics
+- [`/metric-trackers.get`](/beta/api-reference/slas/metric-trackers-get-post): Get a metric tracker
+
+## Modified Endpoints
+
+### Accounts
+- Added `subtype` and `tier` query parameters to [`/accounts.export`](/beta/api-reference/accounts/export-post) and [`/accounts.list`](/beta/api-reference/accounts/list-post)
+- Added `drop` property to `custom_schema_spec` in [`/accounts.create`](/beta/api-reference/accounts/create) and [`/accounts.update`](/beta/api-reference/accounts/update)
+
+### Articles
+- Added `content_format` and `data_sources` properties in [`/articles.create`](/beta/api-reference/articles/create-article) and [`/articles.update`](/beta/api-reference/articles/update-article)
+- Made `applies_to_parts` optional in [`/articles.create`](/beta/api-reference/articles/create-article)
+
+### Commands
+- Added `ai_assistant_chat` and `dm` to allowed object types in surface configuration for [`/commands.create`](/beta/api-reference/commands/create), [`/commands.update`](/beta/api-reference/commands/update) and related endpoints
+
+### Conversations
+- Added `state` query parameter to [`/conversations.list`](/beta/api-reference/conversations/list-post) and [`/conversations.export`](/beta/api-reference/conversations/export-post)
+- Modified `owned_by.set` to allow empty arrays in [`/conversations.update`](/beta/api-reference/conversations/update)
+
+### Groups
+- Added filtering by `created_by`, `name`, and `sync_metadata` fields to [`/groups.list`](/beta/api-reference/groups/list-post)
+
+### Links
+- Added `custom_link_type` property to link objects in [`/links.create`](/beta/api-reference/links/create) and related endpoints
+
+### Meetings
+- Added `sync_metadata` property to meeting objects in [`/meetings.create`](/beta/api-reference/meetings/create) and related endpoints
+
+### Opportunities
+- Added `contacts` property to opportunity objects in work-related endpoints
+
+### SLAs
+- Added `subtype` and `tier` properties to account selector in [`/slas.create`](/beta/api-reference/slas/create) and [`/slas.update`](/beta/api-reference/slas/update)
+
+### Webhooks
+- Added `sla_tracker_fetched` event type to [`/webhooks.create`](/beta/api-reference/webhooks/create), [`/webhooks.update`](/beta/api-reference/webhooks/update) and related endpoints
+
+### Widgets
+- Added `combination` visualization type
+- Removed `percentage_precision` from PVP metric configuration
+
+## Schema Changes
+
+### Custom Schema Spec
+Added `drop` property to `custom_schema_spec` in multiple endpoints including:
+- Account endpoints
+- Article endpoints
+- Chat endpoints
+- Code change endpoints
+- Conversation endpoints
+- Custom object endpoints
+- Dev user endpoints
+- Incident endpoints
+- Meeting endpoints
+- Part endpoints
+- Work endpoints
+
+### Meeting Summary
+Added new subschema to meeting summary objects affecting multiple endpoints that reference meetings
+
+### Link Summary
+Modified link summary schema to support custom link types across multiple endpoints

fern/apis/beta/changelog/2025-06-02.md

@@ -0,0 +1,30 @@
+## New Endpoints
+
+### Chats
+- [`/chats.update`](/beta/api-reference/chats/update): Updates a chat (DM)
+
+### Record Templates
+- [`/record-templates.get`](/beta/api-reference/record-templates/record-template-get-post): Gets a record template's information
+
+### Service Accounts
+- [`/service-accounts.update`](/beta/api-reference/service-accounts/update): Updates a service account's information
+
+### Subscribers
+- [`/subscribers.list`](/beta/api-reference/subscribers/list-post): Lists subscribers for an object
+
+### Surveys
+- [`/surveys.get`](/beta/api-reference/surveys/get-post): Gets the information for a survey
+
+## Modified Endpoints
+
+### Accounts
+- Adds `primary_account` field, which is set when the account is merged with another
+
+### AI Agents
+- Adds `suggestions` agent response type to the `ai_agent_response` webhook event
+
+### Rev Orgs
+- Adds `primary_rev_org` field, which is set when the Rev org (workspace) is merged with another
+
+### Users
+- Adds `primary_identity` field, which is set when the user is merged with another