ai-hist-native 0.31.0 → 0.32.0

package/index.d.ts

@@ -9,7 +9,9 @@ export declare function historyExport(requestJson: string, dbPath?: string | und
  *
  * `op` names the read (`markers`, `requests`, `usage_summary`, `user_turns`,
  * `capabilities`) and `args_json` carries `{dbPath?, source, sessionId?,
- * limit?, after?}`. The answer is the same camelCase document the matching
+ * limit?, after?}`; the change feed's `changes` and `commit_changes` read
+ * `{dbPath?, from?, consumer?, kinds?, session?, limit?}` and
+ * `{dbPath?, consumer, kinds?, position}` (see `change_feed.rs`). The answer is the same camelCase document the matching
  * typed function returns. A missing database answers an empty page, never an
  * error, and never creates the file.
  */
@@ -24,13 +26,33 @@ export declare function nativeContractVersion(): number
  * Performance measurements are only meaningful against `release`.
  */
 export declare function nativeBuildProfile(): string
+/**
+ * Where a newest-first history read stopped: its last row's
+ * `(timestampMs, id)` and, for a search match, its `matchSource`.
+ */
+export interface NativeHistoryCursor {
+  timestampMs: number
+  id: number
+  /** `history` (the default when absent) or `session_event`. */
+  matchSource?: string
+}
 export interface HistoryQueryOptions {
   scope?: string
   dbPath?: string
   source?: string
   project?: string
   tag?: string
+  /**
+   * Deprecated: exclusive, so it skips rows tied on the boundary
+   * timestamp. Page with `after` instead.
+   */
   beforeMs?: number
+  /** Inclusive lower timestamp bound. */
+  sinceMs?: number
+  /** Inclusive upper timestamp bound. */
+  untilMs?: number
+  /** Continue after this row (the previous page's `nextCursor`). */
+  after?: NativeHistoryCursor
   limit?: number
 }
 export interface SearchOptions {
@@ -39,9 +61,31 @@ export interface SearchOptions {
   source?: string
   project?: string
   tag?: string
+  /**
+   * Deprecated: exclusive, so it skips rows tied on the boundary
+   * timestamp. Page with `after` instead.
+   */
   beforeMs?: number
+  /** Inclusive lower timestamp bound. */
+  sinceMs?: number
+  /** Inclusive upper timestamp bound. */
+  untilMs?: number
+  /** Continue after this match (the previous page's `nextCursor`). */
+  after?: NativeHistoryCursor
   limit?: number
   rawFts?: boolean
+  /** `all` (default), `user`, `assistant` or `prompt` — the CLI's `--role`. */
+  role?: string
+}
+export interface NativeSearchPage {
+  matches: Array<NativeSearchMatch>
+  /** Present only when a further match exists. */
+  nextCursor?: NativeHistoryCursor
+}
+export interface NativeHistoryPage {
+  entries: Array<NativeHistoryEntry>
+  /** Present only when a further entry exists. */
+  nextCursor?: NativeHistoryCursor
 }
 export interface SessionOptions {
   dbPath?: string
@@ -57,6 +101,29 @@ export interface NativeHistoryEntry {
   timestampMs: number
   locations: Array<string>
 }
+/**
+ * One `search` match. `id` is unique only within `match_source`: a prompt
+ * is a `history` row, anything else a `session_event` row.
+ */
+export interface NativeSearchMatch {
+  id: number
+  source: string
+  sessionId?: string
+  project?: string
+  /**
+   * The matched text: the prompt for a `history` match, the event text
+   * otherwise. Named `prompt` so a match is still a history entry.
+   */
+  prompt: string
+  timestampMs: number
+  locations: Array<string>
+  /** `history` or `session_event`. */
+  matchSource: string
+  /** `user` for a `history` match; the event's role otherwise. */
+  role: string
+  /** `history` for a `history` match; the event's kind otherwise. */
+  kind: string
+}
 export interface NativeSessionEvent {
   id: number
   source: string
@@ -364,10 +431,17 @@ export interface StatsOptions {
    */
   byCwd?: boolean
 }
-/** Full-text search of indexed history. Never discovers or syncs implicitly. */
-export declare function search(query: string, options?: SearchOptions | undefined | null): Promise<Array<NativeHistoryEntry>>
+/**
+ * Full-text search of indexed prompts and session events. Never discovers or
+ * syncs implicitly. Same contract as `ai-hist search`.
+ */
+export declare function search(query: string, options?: SearchOptions | undefined | null): Promise<Array<NativeSearchMatch>>
+/** One page of `search`, newest first, with the cursor to the next page. */
+export declare function searchPage(query: string, options?: SearchOptions | undefined | null): Promise<NativeSearchPage>
 /** Recent indexed history. Never discovers or syncs implicitly. */
 export declare function recent(options?: HistoryQueryOptions | undefined | null): Promise<Array<NativeHistoryEntry>>
+/** One page of `recent`, newest first, with the cursor to the next page. */
+export declare function recentPage(options?: HistoryQueryOptions | undefined | null): Promise<NativeHistoryPage>
 /** Indexed prompts for one session. Event payloads are separately paginated. */
 export declare function getSession(sessionId: string, options?: SessionOptions | undefined | null): Promise<Array<NativeHistoryEntry>>
 /** One bounded page of normalized events for a session. */

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { historyExport, sessionStoreCall, getSourceObservation, applySourceObservations, applySourceEvidence, nativeContractVersion, nativeBuildProfile, search, recent, getSession, getSessionEventsPage, getSessionToolCallsPage, getSessionUserTurnsPage, getSessionFileEditsPage, getSessionRequestsPage, getSessionUsage, stats, listSessionCatalogPage, listSessionCatalog, discoverSessions, hydrateSession, getSessionRelationships, getSessionTree, getSessionChildrenPage, sync, syncLocal, installGitHooks, linkGitCommit } = nativeBinding
+const { historyExport, sessionStoreCall, getSourceObservation, applySourceObservations, applySourceEvidence, nativeContractVersion, nativeBuildProfile, search, searchPage, recent, recentPage, getSession, getSessionEventsPage, getSessionToolCallsPage, getSessionUserTurnsPage, getSessionFileEditsPage, getSessionRequestsPage, getSessionUsage, stats, listSessionCatalogPage, listSessionCatalog, discoverSessions, hydrateSession, getSessionRelationships, getSessionTree, getSessionChildrenPage, sync, syncLocal, installGitHooks, linkGitCommit } = nativeBinding
 
 module.exports.historyExport = historyExport
 module.exports.sessionStoreCall = sessionStoreCall
@@ -320,7 +320,9 @@ module.exports.applySourceEvidence = applySourceEvidence
 module.exports.nativeContractVersion = nativeContractVersion
 module.exports.nativeBuildProfile = nativeBuildProfile
 module.exports.search = search
+module.exports.searchPage = searchPage
 module.exports.recent = recent
+module.exports.recentPage = recentPage
 module.exports.getSession = getSession
 module.exports.getSessionEventsPage = getSessionEventsPage
 module.exports.getSessionToolCallsPage = getSessionToolCallsPage

package/npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-darwin-arm64",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "darwin"
   ],

package/npm/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-darwin-x64",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "darwin"
   ],

package/npm/linux-arm64-gnu/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-linux-arm64-gnu",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "linux"
   ],

package/npm/linux-arm64-musl/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-linux-arm64-musl",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "linux"
   ],

package/npm/linux-x64-gnu/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-linux-x64-gnu",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "linux"
   ],

package/npm/linux-x64-musl/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-linux-x64-musl",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "linux"
   ],

package/npm/win32-x64-msvc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native-win32-x64-msvc",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "os": [
     "win32"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Mandatory Node-API engine for RelayHistory.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -44,12 +44,12 @@
     "@napi-rs/cli": "^2.18.4"
   },
   "optionalDependencies": {
-    "ai-hist-native-darwin-arm64": "0.31.0",
-    "ai-hist-native-darwin-x64": "0.31.0",
-    "ai-hist-native-linux-x64-gnu": "0.31.0",
-    "ai-hist-native-linux-arm64-gnu": "0.31.0",
-    "ai-hist-native-linux-x64-musl": "0.31.0",
-    "ai-hist-native-linux-arm64-musl": "0.31.0",
-    "ai-hist-native-win32-x64-msvc": "0.31.0"
+    "ai-hist-native-darwin-arm64": "0.32.0",
+    "ai-hist-native-darwin-x64": "0.32.0",
+    "ai-hist-native-linux-x64-gnu": "0.32.0",
+    "ai-hist-native-linux-arm64-gnu": "0.32.0",
+    "ai-hist-native-linux-x64-musl": "0.32.0",
+    "ai-hist-native-linux-arm64-musl": "0.32.0",
+    "ai-hist-native-win32-x64-msvc": "0.32.0"
   }
 }