dsh-reference-anything 0.2.0

package/opencli-plugin/gemini.js

@@ -0,0 +1,165 @@
+import { domFallbackScript, registerProvider, sinceGuardSource } from './common.js'
+// OpenCLI discovery marker: registerProvider below performs the cli() calls.
+
+export const timestampSource = String.raw`value => {
+  if (Array.isArray(value)) {
+    if (value.length === 0) return ''
+    const seconds = Number(value[0])
+    const nanos = Number(value[1] || 0)
+    if (Number.isFinite(seconds) && seconds > 0 && seconds < 1e11) {
+      const date = new Date(seconds * 1000 + (Number.isFinite(nanos) ? nanos / 1e6 : 0))
+      return Number.isNaN(date.getTime()) ? '' : date.toISOString()
+    }
+    value = value[0]
+  }
+  if (value === undefined || value === null || value === '') return ''
+  if (typeof value === 'string' && Number.isNaN(Number(value))) {
+    const parsed = Date.parse(value)
+    return Number.isNaN(parsed) ? '' : new Date(parsed).toISOString()
+  }
+  const numeric = Number(value)
+  if (!Number.isFinite(numeric) || numeric <= 0) return ''
+  const milliseconds = numeric < 1e11 ? numeric * 1000
+    : numeric < 1e14 ? numeric : numeric < 1e17 ? numeric / 1000 : numeric / 1e6
+  const date = new Date(milliseconds)
+  return Number.isNaN(date.getTime()) ? '' : date.toISOString()
+}`
+
+const helpers = String.raw`
+  const toIso = (${timestampSource})
+  const auth = () => {
+    const wiz = window.__WIZ_global_data || window.WIZ_global_data || {}
+    if (wiz.SNlM0e) return String(wiz.SNlM0e)
+    for (const script of document.scripts) {
+      const match = (script.textContent || '').match(/"SNlM0e"\s*:\s*"([^"]+)"/)
+      if (match) return match[1]
+    }
+    return ''
+  }
+  const sid = () => {
+    const entries = performance.getEntriesByType('resource') || []
+    for (let index = entries.length - 1; index >= 0; index--) {
+      try {
+        const value = new URL(entries[index].name).searchParams.get('f.sid')
+        if (value) return value
+      } catch {}
+    }
+    return ''
+  }
+  const rpc = async (id, sourcePath, args) => {
+    const token = auth()
+    if (!token) return { code: 'AUTH' }
+    const query = new URLSearchParams({ rpcids: id, 'source-path': sourcePath,
+      'f.sid': sid(), _reqid: String(Math.floor(Math.random() * 100000)), rt: 'c' })
+    const body = new URLSearchParams({ 'f.req': JSON.stringify([[[id, JSON.stringify(args), null, 'generic']]]), at: token })
+    const response = await fetch('/_/BardChatUi/data/batchexecute?' + query, {
+      method: 'POST', credentials: 'include', headers: { 'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8', 'X-Same-Domain': '1' }, body,
+    })
+    if (response.status === 401 || response.status === 403) return { code: 'AUTH' }
+    if (response.status === 429) return { code: 'RATE_LIMIT' }
+    if (!response.ok) return { error: 'batchexecute HTTP ' + response.status }
+    const text = await response.text()
+    for (const line of text.split('\n')) {
+      const at = line.indexOf('[[')
+      if (at < 0) continue
+      try {
+        const outer = JSON.parse(line.slice(at))
+        for (const entry of outer) if (Array.isArray(entry) && entry[0] === 'wrb.fr' && entry[1] === id && typeof entry[2] === 'string') return { payload: JSON.parse(entry[2]) }
+      } catch {}
+    }
+    return { error: 'batchexecute returned no typed payload' }
+  }
+`
+
+const historyScript = String.raw`async function (args) {
+  ${helpers}
+  const stopEarly = (${sinceGuardSource})(args && args.since)
+  const rows = []
+  const byId = new Map()
+  let complete = true
+  try {
+    for (const mode of [1, 0]) {
+      let cursor = null
+      const seen = new Set()
+      for (let page = 0; page < 200; page++) {
+        const result = await rpc('MaZiqc', '/app', [100, cursor, [mode, null, 1]])
+        if (result.code) return JSON.stringify({ ok: false, code: result.code })
+        if (!Array.isArray(result.payload)) { complete = false; break }
+        const pageRows = []
+        const walk = value => {
+          if (!Array.isArray(value)) return
+          if (typeof value[0] === 'string' && /^c_[A-Za-z0-9_-]+$/.test(value[0]) && typeof (value[1] || value[2]) === 'string') {
+            const id = value[0].slice(2)
+            if (!byId.has(id)) {
+              const row = { provider: 'gemini', accountScope: '', id,
+                title: String(value[1] || value[2]), url: location.origin + '/app/' + encodeURIComponent(id),
+                createdAt: '', updatedAt: toIso(value[5]), messageCount: 0, cursor: '', partial: false }
+              byId.set(id, row)
+              pageRows.push(row)
+            }
+          }
+          for (const child of value) walk(child)
+        }
+        walk(result.payload)
+        const nested = Array.isArray(result.payload[0]) ? result.payload[0] : []
+        const next = typeof result.payload[1] === 'string' ? result.payload[1] : typeof nested[1] === 'string' ? nested[1] : ''
+        if (!next) break
+        if (stopEarly(pageRows)) break
+        if (seen.has(next)) { complete = false; break }
+        seen.add(next); cursor = next
+      }
+    }
+    rows.push(...byId.values())
+    return JSON.stringify({ ok: true, rows: rows.map(row => ({ ...row, partial: !complete })) })
+  } catch (error) {
+    const links = Array.from(document.querySelectorAll('a[href*="/app/"]'))
+    for (const link of links) {
+      const match = link.href.match(/\/app\/([A-Za-z0-9_-]+)/)
+      if (!match || byId.has(match[1])) continue
+      byId.set(match[1], true)
+      rows.push({ provider: 'gemini', accountScope: '', id: match[1], title: (link.textContent || '').trim() || 'Untitled Gemini chat',
+        url: link.href, createdAt: '', updatedAt: '', messageCount: 0, cursor: '', partial: true })
+    }
+    return JSON.stringify({ ok: rows.length > 0, rows, message: String(error && error.message || error) })
+  }
+}`
+
+const detailScript = String.raw`async function (args) {
+  ${helpers}
+  try {
+    const id = String(args.id).replace(/^c_/, '')
+    const result = await rpc('hNvQHb', '/app/' + id, ['c_' + id, 1000, null, 1, [1], [4], null, 1])
+    if (result.code) return JSON.stringify({ ok: false, code: result.code })
+    const turns = result.payload && result.payload[0]
+    if (!Array.isArray(turns)) return JSON.stringify({ ok: false, message: result.error || 'Gemini detail payload missing turns' })
+    const rows = []
+    for (const turn of turns.slice().reverse()) {
+      if (!Array.isArray(turn)) continue
+      const stamp = turn && turn[4]
+      const createdAt = toIso(stamp)
+      const responseId = turn && turn[0] && typeof turn[0][1] === 'string' ? turn[0][1] : String(rows.length)
+      const user = turn && turn[2] && turn[2][0] && turn[2][0][0]
+      const assistant = turn && turn[3] && turn[3][0] && turn[3][0][0] && turn[3][0][0][1] && turn[3][0][0][1][0]
+      if (typeof user === 'string' && user.trim()) rows.push({ conversationId: id, ordinal: rows.length,
+        messageId: responseId + '-user', parentId: '', branchId: responseId, activeBranch: true,
+        role: 'user', text: user.trim(), createdAt, attachmentsJson: '[]', partial: false })
+      if (typeof assistant === 'string' && assistant.trim()) rows.push({ conversationId: id, ordinal: rows.length,
+        messageId: responseId, parentId: responseId + '-user', branchId: responseId, activeBranch: true,
+        role: 'assistant', text: assistant.trim(), createdAt, attachmentsJson: '[]', partial: false })
+    }
+    return JSON.stringify({ ok: rows.length > 0, rows })
+  } catch (error) {
+    return JSON.stringify({ ok: false, message: String(error && error.message || error) })
+  }
+}`
+
+registerProvider({
+  site: 'dsh-gemini', provider: 'Gemini', domain: 'gemini.google.com', home: 'https://gemini.google.com/app',
+  conversationUrl: id => `https://gemini.google.com/app/${encodeURIComponent(id)}`,
+  whoamiScript: String.raw`async function () {
+    const match = location.pathname.match(/\/u\/(\d+)(?:\/|$)/); const slot = match ? match[1] : 'default'
+    const wiz = window.__WIZ_global_data || window.WIZ_global_data || {}; const identity = String(wiz.oPEP7c || wiz.CfO9Re || slot)
+    return JSON.stringify({ ok: Boolean(identity), identity })
+  }`,
+  historyScript, detailScript, fallbackScript: domFallbackScript,
+})

package/opencli-plugin/grok.js

@@ -0,0 +1,123 @@
+import { domFallbackScript, registerProvider, sinceGuardSource } from './common.js'
+// OpenCLI discovery marker: registerProvider below performs the cli() calls.
+
+const historyScript = String.raw`async function (args) {
+  const stopEarly = (${sinceGuardSource})(args && args.since)
+  const rows = []
+  const seen = new Set()
+  let token = ''
+  try {
+    for (let page = 0; page < 200; page++) {
+      const url = '/rest/app-chat/conversations?pageSize=100' + (token ? '&pageToken=' + encodeURIComponent(token) : '')
+      const response = await fetch(url, { credentials: 'include', headers: { Accept: 'application/json' } })
+      if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+      if (response.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+      if (!response.ok) throw new Error('history HTTP ' + response.status)
+      const payload = await response.json()
+      const arrays = Object.values(payload || {}).filter(Array.isArray)
+      const pageStart = rows.length
+      for (const record of arrays.flat()) {
+        if (!record || typeof record !== 'object') continue
+        const id = String(record.conversationId || record.id || '')
+        if (!id || seen.has(id)) continue
+        seen.add(id)
+        rows.push({ provider: 'grok', accountScope: '', id,
+          title: String(record.title || record.name || 'Untitled Grok chat'),
+          url: location.origin + '/c/' + encodeURIComponent(id),
+          createdAt: String(record.createTime || record.createdAt || record.created_at || ''),
+          updatedAt: String(record.updateTime || record.updatedAt || record.updated_at || record.createTime || ''),
+          messageCount: Number(record.messageCount || record.message_count || 0),
+          cursor: String(payload.nextPageToken || ''), partial: false })
+      }
+      const next = String(payload.nextPageToken || '')
+      if (!next) break
+      if (stopEarly(rows.slice(pageStart))) break
+      if (next === token) throw new Error('repeated Grok cursor')
+      token = next
+    }
+    return JSON.stringify({ ok: true, rows })
+  } catch (error) {
+    const links = Array.from(document.querySelectorAll('a[href*="/c/"]'))
+    for (const link of links) {
+      const match = link.href.match(/\/c\/([^/?#]+)/)
+      if (!match || seen.has(match[1])) continue
+      seen.add(match[1])
+      rows.push({ provider: 'grok', accountScope: '', id: match[1],
+        title: (link.textContent || '').trim() || 'Untitled Grok chat', url: link.href,
+        createdAt: '', updatedAt: '', messageCount: 0, cursor: '', partial: true })
+    }
+    return JSON.stringify({ ok: rows.length > 0, rows, message: String(error && error.message || error) })
+  }
+}`
+
+const detailScript = String.raw`async function (args) {
+  try {
+    const init = { credentials: 'include', headers: { Accept: 'application/json' } }
+    const detailResponse = await fetch('/rest/app-chat/conversations_v2/' + encodeURIComponent(args.id), init)
+    if (detailResponse.status === 401 || detailResponse.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+    if (detailResponse.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+    if (!detailResponse.ok) throw new Error('detail HTTP ' + detailResponse.status)
+    const detailPayload = await detailResponse.json()
+    const detail = detailPayload.conversation || detailPayload
+    const nodeResponse = await fetch('/rest/app-chat/conversations/' + encodeURIComponent(args.id) + '/response-node', init)
+    if (nodeResponse.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+    if (!nodeResponse.ok) throw new Error('response-node HTTP ' + nodeResponse.status)
+    const nodesPayload = await nodeResponse.json()
+    const nodes = Array.isArray(nodesPayload.responseNodes) ? nodesPayload.responseNodes : []
+    const ids = Array.from(new Set(nodes.map(node => String(node.responseId || '')).filter(Boolean)))
+    if (!ids.length) throw new Error('response-node returned no ids')
+    const messagesResponse = await fetch('/rest/app-chat/conversations/' + encodeURIComponent(args.id) + '/load-responses', {
+      ...init, method: 'POST', headers: { ...init.headers, 'Content-Type': 'application/json' }, body: JSON.stringify({ responseIds: ids }),
+    })
+    if (messagesResponse.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+    if (!messagesResponse.ok) throw new Error('load-responses HTTP ' + messagesResponse.status)
+    const messagesPayload = await messagesResponse.json()
+    const records = Array.isArray(messagesPayload.responses) ? messagesPayload.responses : []
+    const byId = new Map(records.map(record => [String(record.responseId || ''), record]))
+    const rows = []
+    for (const responseId of ids) {
+      const record = byId.get(responseId)
+      if (!record) continue
+      const sender = String(record.sender || '').toLowerCase()
+      const role = /human|user/.test(sender) ? 'user' : /assistant|bot|grok/.test(sender) ? 'assistant' : null
+      const text = String(record.message || '').replace(/<grok:render[^>]*>[\s\S]*?<\/grok:render>/gi, '').trim()
+      if (!role || !text) continue
+      const files = record.attachments || record.files || []
+      const attachments = (Array.isArray(files) ? files : []).map((file, index) => {
+        const candidate = String(file.url || file.downloadUrl || '')
+        let locator = ''
+        try { if (candidate) { const url = new URL(candidate, location.origin); if (url.origin === location.origin && url.pathname !== '/') locator = url.pathname + url.search } } catch {}
+        const name = String(file.name || 'attachment')
+        const mimeType = String(file.mimeType || file.mime_type || '')
+        return { attachmentId: String(file.id || index), kind: mimeType.startsWith('image/') || /\.(?:gif|jpe?g|png|webp)$/i.test(name) ? 'image' : 'file', name,
+          mimeType, size: Number(file.size || 0),
+          locator, status: locator ? 'available' : 'unavailable' }
+      })
+      rows.push({ conversationId: args.id, ordinal: rows.length, messageId: responseId,
+        parentId: String(record.parentResponseId || ''), branchId: String(record.branchId || ''), activeBranch: true,
+        role, text, createdAt: String(record.createTime || ''), attachmentsJson: JSON.stringify(attachments), partial: false })
+    }
+    return JSON.stringify({ ok: rows.length > 0, rows, title: detail.title || '' })
+  } catch (error) {
+    return JSON.stringify({ ok: false, message: String(error && error.message || error) })
+  }
+}`
+
+export const whoamiScript = String.raw`async function () {
+  for (const url of ['/api/auth/session', '/rest/app-chat/users/me', '/rest/auth/me']) {
+    const response = await fetch(url, { credentials: 'include', headers: { Accept: 'application/json' } })
+    if (!response.ok) continue
+    const payload = await response.json()
+    const user = payload.session || payload.user || payload
+    const identity = String(user.userId || user.id || user.xUserId || user.email || '')
+    if (identity) return JSON.stringify({ ok: true, identity })
+  }
+  return JSON.stringify({ ok: false, code: 'AUTH' })
+}`
+
+registerProvider({
+  site: 'dsh-grok', provider: 'Grok', domain: 'grok.com', home: 'https://grok.com/',
+  conversationUrl: id => `https://grok.com/c/${encodeURIComponent(id)}`,
+  whoamiScript,
+  historyScript, detailScript, fallbackScript: domFallbackScript,
+})

package/opencli-plugin/kimi.js

@@ -0,0 +1,123 @@
+import { domFallbackScript, registerProvider, sinceGuardSource } from './common.js'
+// OpenCLI discovery marker: registerProvider below performs the cli() calls.
+
+const authHeaders = String.raw`() => {
+  const token = localStorage.getItem('access_token') || ''
+  return { Accept: 'application/json', 'Content-Type': 'application/json', ...(token ? { Authorization: 'Bearer ' + token } : {}) }
+}`
+
+const historyScript = String.raw`async function (args) {
+  const stopEarly = (${sinceGuardSource})(args && args.since)
+  const headers = (${authHeaders})()
+  const rows = []
+  const toDate = value => {
+    const numeric = Number(value)
+    return Number.isFinite(numeric) && numeric > 0 ? new Date(numeric < 1e12 ? numeric * 1000 : numeric).toISOString() : String(value || '')
+  }
+  try {
+    for (let offset = 0, page = 0; page < 500; page++, offset += 100) {
+      const response = await fetch('/api/chat/list', { method: 'POST', credentials: 'include', headers,
+        body: JSON.stringify({ offset, size: 100 }) })
+      if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+      if (response.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+      if (!response.ok) throw new Error('history HTTP ' + response.status)
+      const payload = await response.json()
+      const items = payload.items || payload.chats || payload.data && (payload.data.items || payload.data.chats) || []
+      const pageStart = rows.length
+      for (const item of items) {
+        const id = String(item.id || item.chat_id || '')
+        if (!id) continue
+        rows.push({ provider: 'kimi', accountScope: '', id,
+          title: String(item.name || item.title || 'Untitled Kimi chat'),
+          url: location.origin + '/chat/' + encodeURIComponent(id),
+          createdAt: toDate(item.created_at || item.createdAt || item.created),
+          updatedAt: toDate(item.updated_at || item.updatedAt || item.last_updated_at || item.created_at),
+          messageCount: Number(item.message_count || item.messageCount || item.messages_count || 0),
+          cursor: String(item.updated_at || item.updatedAt || ''), partial: false })
+      }
+      if (items.length < 100 || stopEarly(rows.slice(pageStart))) break
+    }
+    return JSON.stringify({ ok: true, rows })
+  } catch (error) {
+    const seen = new Set()
+    for (const link of document.querySelectorAll('a[href*="/chat/"]')) {
+      const match = link.href.match(/\/chat\/([0-9a-f-]{8,})/i)
+      if (!match || seen.has(match[1])) continue
+      seen.add(match[1]); rows.push({ provider: 'kimi', accountScope: '', id: match[1],
+        title: (link.textContent || '').trim() || 'Untitled Kimi chat', url: link.href,
+        createdAt: '', updatedAt: '', messageCount: 0, cursor: '', partial: true })
+    }
+    return JSON.stringify({ ok: rows.length > 0, rows, message: rows.length ? '' : String(error && error.message || error) })
+  }
+}`
+
+export const detailScript = String.raw`async function (args) {
+  const headers = (${authHeaders})()
+  const textOf = value => typeof value === 'string' ? value
+    : Array.isArray(value) ? value.map(textOf).filter(Boolean).join('\n')
+    : value && typeof value === 'object' ? textOf(value.text || value.content || value.value || value.output || '') : ''
+  const attachmentOf = (file, index) => {
+    if (!file || typeof file !== 'object') return null
+    const candidate = String(file.download_url || file.url || file.path || '')
+    let locator = ''
+    try { if (candidate) { const url = new URL(candidate, location.origin); if (url.origin === location.origin && url.pathname !== '/') locator = url.pathname + url.search } } catch {}
+    const name = String(file.name || file.file_name || 'attachment')
+    const mimeType = String(file.mime_type || file.mimeType || file.content_type || '')
+    return { attachmentId: String(file.id || file.file_id || index),
+      kind: mimeType.startsWith('image/') || /\.(?:gif|jpe?g|png|webp)$/i.test(name) ? 'image' : 'file',
+      name, mimeType, size: Number(file.size || file.file_size || 0), locator,
+      status: locator ? 'available' : 'unavailable' }
+  }
+  try {
+    const messages = []
+    let pageToken = ''
+    for (let page = 0; page < 500; page++) {
+      let response = await fetch('/apiv2/kimi.chat.v1.ChatService/ListMessages', { method: 'POST', credentials: 'include', headers,
+        body: JSON.stringify({ chat_id: args.id, ...(pageToken ? { pageToken } : {}) }) })
+      if ((response.status === 404 || response.status === 405) && page === 0) {
+        response = await fetch('/api/chat/' + encodeURIComponent(args.id) + '/messages', { credentials: 'include', headers })
+      }
+      if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+      if (response.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+      if (!response.ok) throw new Error('detail HTTP ' + response.status)
+      const payload = await response.json()
+      const items = payload.messages || payload.items || payload.data && (payload.data.messages || payload.data.items) || []
+      messages.push(...items)
+      const next = String(payload.nextPageToken || payload.next_page_token || payload.data && (payload.data.nextPageToken || payload.data.next_page_token) || '')
+      if (!next || next === pageToken || items.length === 0) break
+      pageToken = next
+    }
+    // Kimi lists newest messages first. The local mirror and every other
+    // adapter use chronological ordinals, so reverse only after all pages land.
+    messages.reverse()
+    const rows = messages.map((message, ordinal) => {
+      const roleRaw = String(message.role || message.sender || message.message_role || message.type || '').toLowerCase()
+      const role = /assistant|bot|model|kimi/.test(roleRaw) ? 'assistant' : 'user'
+      const files = message.attachments || message.files || message.file_infos || []
+      const attachments = (Array.isArray(files) ? files : []).map(attachmentOf).filter(Boolean)
+      return { conversationId: args.id, ordinal,
+        messageId: String(message.id || message.message_id || ordinal),
+        parentId: String(message.parent_id || message.parentId || ''), branchId: '', activeBranch: true,
+        role, text: textOf(message.blocks || message.contents || message.content || message.text || message.fragments || ''),
+        createdAt: String(message.created_at || message.createdAt || message.timestamp || ''),
+        attachmentsJson: JSON.stringify(attachments), partial: false }
+    }).filter(row => row.text || row.attachmentsJson !== '[]')
+    return JSON.stringify({ ok: rows.length > 0, rows, message: rows.length ? '' : 'response contained no messages' })
+  } catch (error) {
+    return JSON.stringify({ ok: false, message: String(error && error.message || error) })
+  }
+}`
+
+registerProvider({
+  site: 'dsh-kimi', provider: 'Kimi', domain: 'kimi.com', home: 'https://www.kimi.com/',
+  conversationUrl: id => `https://www.kimi.com/chat/${encodeURIComponent(id)}`,
+  whoamiScript: String.raw`async function () {
+    const headers = (${authHeaders})()
+    const response = await fetch('/api/user', { credentials: 'include', headers })
+    if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+    if (!response.ok) return JSON.stringify({ ok: false, message: 'user HTTP ' + response.status })
+    const user = await response.json(); const identity = String(user.id || user.user_id || user.email || '')
+    return JSON.stringify({ ok: Boolean(identity), identity, code: identity ? undefined : 'AUTH' })
+  }`,
+  historyScript, detailScript, fallbackScript: domFallbackScript,
+})

package/opencli-plugin/opencli-plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "dsh-chat-history",
+  "version": "0.2.0",
+  "opencli": ">=1.8.6",
+  "description": "Full-history read adapters used by dsh-reference-anything"
+}

package/opencli-plugin/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "opencli-plugin-dsh-chat-history",
+  "version": "0.2.0",
+  "type": "module",
+  "peerDependencies": {
+    "@jackwener/opencli": ">=1.8.6"
+  }
+}

package/opencli-plugin/since-guard.js

@@ -0,0 +1,45 @@
+/**
+ * Early-stop helper shared by every provider's history script.
+ *
+ * Lives in its own module, free of imports, so it can be unit-tested without
+ * the OpenCLI registry that `common.js` pulls in.
+ */
+
+/**
+ * Source of the guard, embedded into each provider's page script.
+ *
+ * Paging may only stop early while the provider actually returns
+ * conversations newest-first, which not every one of these endpoints
+ * documents. So the guard watches the `updatedAt` sequence it is fed and
+ * authorizes a stop only while that sequence has been non-increasing *and*
+ * the whole current page already predates the cutoff. A provider that pages
+ * in some other order, or that omits timestamps, walks its full history
+ * exactly as it did before `since` existed.
+ */
+export const sinceGuardSource = String.raw`function (since) {
+  const cutoff = since ? Date.parse(since) : NaN
+  let previous = Infinity
+  let ordered = true
+  return function (page) {
+    if (!(cutoff > 0) || page.length === 0) return false
+    let older = true
+    for (const row of page) {
+      const at = Date.parse(row.updatedAt || '')
+      if (!(at > 0)) return false
+      if (at > previous) ordered = false
+      previous = at
+      if (at >= cutoff) older = false
+    }
+    return ordered && older
+  }
+}`
+
+/**
+ * Materialize the guard for tests and for any caller that wants it directly.
+ * @param {string} since - ISO instant, or '' to disable early stopping.
+ * @returns {(page: Array<{updatedAt?: string}>) => boolean} whether paging may stop.
+ */
+export function createSinceGuard(since) {
+  // eslint-disable-next-line no-eval -- the source is a package constant, never caller data.
+  return (0, eval)(`(${sinceGuardSource})`)(since)
+}

package/package.json

@@ -0,0 +1,180 @@
+{
+  "name": "dsh-reference-anything",
+  "version": "0.2.0",
+  "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Chael-Chael/dsh-reference-anything.git"
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./reference": {
+      "types": "./lib/reference.d.ts",
+      "default": "./lib/reference.js"
+    },
+    "./tool": {
+      "types": "./lib/tool.d.ts",
+      "default": "./lib/tool.js"
+    },
+    "./file": {
+      "types": "./lib/sources/file.d.ts",
+      "default": "./lib/sources/file.js"
+    },
+    "./web-chat": {
+      "types": "./lib/sources/web-chat/index.d.ts",
+      "default": "./lib/sources/web-chat/index.js"
+    },
+    "./web": {
+      "types": "./lib/web.d.ts",
+      "default": "./lib/web.js"
+    },
+    "./sync": {
+      "types": "./lib/sync/index.d.ts",
+      "default": "./lib/sync/index.js"
+    },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "opencli-plugin/*.js",
+    "opencli-plugin/opencli-plugin.json",
+    "opencli-plugin/package.json",
+    "cordis.patch.yml",
+    "images/logo.png",
+    "NOTICE.md",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-input-trigger",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "check": "pnpm run typecheck && pnpm run test && pnpm run build",
+    "prepublishOnly": "pnpm run check",
+    "prepare": "node build.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1",
+    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-api-remotes": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-attachment": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-output-retention": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-reference": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-storage-domain": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-registry": ">=0.0.1-rc.1",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-session-reference": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-remotes": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-input-trigger": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@lobehub/icons": "^5.16.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "link:../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-agent": "link:../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-api-remotes": "link:../deepseek-harness/packages/api/remotes",
+    "@deepseek-ai/dsh-attachment": "link:../deepseek-harness/packages/attachment/attachment",
+    "@deepseek-ai/dsh-client-connection": "link:../deepseek-harness/packages/client/connection",
+    "@deepseek-ai/dsh-client-locale": "link:../deepseek-harness/packages/client/locale",
+    "@deepseek-ai/dsh-client-runtime": "link:../deepseek-harness/packages/client/runtime",
+    "@deepseek-ai/dsh-client-ui-conversation": "link:../deepseek-harness/packages/client/ui-conversation",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "link:../deepseek-harness/packages/client/ui-input-trigger",
+    "@deepseek-ai/dsh-client-ui-settings": "link:../deepseek-harness/packages/client/ui-settings",
+    "@deepseek-ai/dsh-client-ui-slots": "link:../deepseek-harness/packages/client/ui-slots",
+    "@deepseek-ai/dsh-llm": "link:../deepseek-harness/packages/llm/llm",
+    "@deepseek-ai/dsh-output-retention": "link:../deepseek-harness/packages/util/output-retention",
+    "@deepseek-ai/dsh-session": "link:../deepseek-harness/packages/core/session",
+    "@deepseek-ai/dsh-session-reference": "link:../deepseek-harness/packages/context/session-reference",
+    "@deepseek-ai/dsh-settings": "link:../deepseek-harness/packages/settings/settings",
+    "@deepseek-ai/dsh-storage-domain": "link:../deepseek-harness/packages/storage/storage-domain",
+    "@deepseek-ai/dsh-system-prompt": "link:../deepseek-harness/packages/core/system-prompt",
+    "@deepseek-ai/dsh-tools": "link:../deepseek-harness/packages/core/tools",
+    "@deepseek-ai/dsh-typert-protocol": "link:../deepseek-harness/packages/typert/protocol",
+    "@deepseek-ai/dsh-typert-registry": "link:../deepseek-harness/packages/typert/registry",
+    "@types/node": "^22.20.1",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.3.7",
+    "esbuild": "^0.25.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}