ai-hist-native 0.4.3 → 0.8.2

package/index.d.ts

@@ -3,16 +3,200 @@
 
 /* auto-generated by NAPI-RS */
 
-/** Result of one in-process sync+push. */
+/** Contract version implemented by this native addon. */
+export declare function nativeContractVersion(): number
+/**
+ * Optimization profile this addon was compiled with: `release` or `debug`.
+ * Performance measurements are only meaningful against `release`.
+ */
+export declare function nativeBuildProfile(): string
+export interface HistoryQueryOptions {
+  dbPath?: string
+  source?: string
+  project?: string
+  tag?: string
+  beforeMs?: number
+  limit?: number
+}
+export interface SearchOptions {
+  dbPath?: string
+  source?: string
+  project?: string
+  tag?: string
+  beforeMs?: number
+  limit?: number
+  rawFts?: boolean
+}
+export interface SessionOptions {
+  dbPath?: string
+  source?: string
+  tag?: string
+}
+export interface NativeHistoryEntry {
+  id: number
+  source: string
+  sessionId?: string
+  project?: string
+  prompt: string
+  timestampMs: number
+}
+export interface NativeSessionEvent {
+  id: number
+  source: string
+  sessionId: string
+  project?: string
+  cwd?: string
+  gitBranch?: string
+  messageId?: string
+  parentId?: string
+  tsMs: number
+  role: string
+  kind: string
+  text?: string
+  model?: string
+  tokenJson?: string
+  eventUid: string
+}
+export interface EventCursor {
+  tsMs: number
+  id: number
+}
+export interface EventsPageOptions {
+  dbPath?: string
+  source?: string
+  limit?: number
+  after?: EventCursor
+}
+export interface SessionEventsPage {
+  events: Array<NativeSessionEvent>
+  nextCursor?: EventCursor
+}
+export interface SourceCount {
+  source: string
+  count: number
+}
+export interface ProjectCount {
+  project: string
+  count: number
+}
+export interface NativeStats {
+  total: number
+  bySource: Array<SourceCount>
+  byProject: Array<ProjectCount>
+  firstTimestampMs?: number
+  lastTimestampMs?: number
+}
+export interface StatsOptions {
+  dbPath?: string
+  tag?: string
+}
+/** Full-text search of indexed history. Never discovers or syncs implicitly. */
+export declare function search(query: string, options?: SearchOptions | undefined | null): Promise<Array<NativeHistoryEntry>>
+/** Recent indexed history. Never discovers or syncs implicitly. */
+export declare function recent(options?: HistoryQueryOptions | undefined | null): Promise<Array<NativeHistoryEntry>>
+/** 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. */
+export declare function getSessionEventsPage(sessionId: string, options?: EventsPageOptions | undefined | null): Promise<SessionEventsPage>
+/** Database statistics over already-indexed data. */
+export declare function stats(options?: StatsOptions | undefined | null): Promise<NativeStats>
+export interface CatalogSession {
+  source: string
+  sessionId: string
+  cwd?: string
+  gitBranch?: string
+  firstActivityMs?: number
+  lastActivityMs?: number
+  firstPrompt?: string
+  lastAssistantText?: string
+  models: Array<string>
+  originator?: string
+  agentVersion?: string
+  repoUrl?: string
+  initialCommit?: string
+  workspaceRoots: Array<string>
+  rawPath?: string
+  sourceStamp?: string
+  discoveryState: string
+  fromCache: boolean
+}
+export interface CatalogCursor {
+  lastActivityMs?: number
+  source: string
+  sessionId: string
+}
+export interface ListCatalogOptions {
+  dbPath?: string
+  sources?: Array<string>
+  limit?: number
+  beforeMs?: number
+  after?: CatalogCursor
+}
+export interface SessionCatalogPage {
+  contractVersion: number
+  sessions: Array<CatalogSession>
+  nextCursor?: CatalogCursor
+}
+/** Cache-only indexed catalog query. Missing databases return an empty page. */
+export declare function listSessionCatalogPage(options?: ListCatalogOptions | undefined | null): Promise<SessionCatalogPage>
+/** Convenience first-page catalog listing with identical cache-only semantics. */
+export declare function listSessionCatalog(options?: ListCatalogOptions | undefined | null): Promise<Array<CatalogSession>>
+export interface DiscoverOptions {
+  dbPath?: string
+  sources?: Array<string>
+  limit?: number
+}
+export interface DiscoveryDiagnostic {
+  source: string
+  locator?: string
+  error: string
+}
+export interface ProviderSummary {
+  source: string
+  candidates: number
+  discovered: number
+  skippedUnchanged: number
+  failed: boolean
+}
+export interface DiscoveryCounters {
+  candidatesEnumerated: number
+  shallowReads: number
+  skippedUnchanged: number
+  filesOpened: number
+  bytesRead: number
+}
+export interface SourceExemption {
+  source: string
+  reason: string
+}
+export interface DiscoverResult {
+  contractVersion: number
+  sessions: Array<CatalogSession>
+  discovered: number
+  skippedUnchanged: number
+  providers: Array<ProviderSummary>
+  exemptSources: Array<SourceExemption>
+  diagnostics: Array<DiscoveryDiagnostic>
+  counters: DiscoveryCounters
+}
+/** Explicit bounded provider discovery. It updates only the session catalog. */
+export declare function discoverSessions(options?: DiscoverOptions | undefined | null): Promise<DiscoverResult>
+export interface SyncOptions {
+  dbPath?: string
+}
+export interface SyncResult {
+  databasePath: string
+  completed: boolean
+}
+/** Explicit full ingestion. A read operation never calls this implicitly. */
+export declare function sync(options?: SyncOptions | undefined | null): Promise<SyncResult>
+/** Backward-compatible internal capture entry point; not used by the SDK. */
+export declare function syncLocal(): Promise<void>
 export interface SyncPushResult {
   sent: number
   accepted: number
-  /** `false` when there's no stored relayhistory auth yet (a no-op, not an error). */
   authenticated: boolean
+  syncSkipped: boolean
 }
-/**
- * Sync local agent history into the ai-hist DB, then push new records to
- * relayhistory-cloud. The blocking work (file/SQLite/HTTP) runs on a worker
- * thread so the Node event loop is never blocked.
- */
+/** Cloud capture hook retained for Agent Relay integration. */
 export declare function syncAndPush(): Promise<SyncPushResult>

package/index.js

@@ -310,6 +310,18 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { syncAndPush } = nativeBinding
+const { nativeContractVersion, nativeBuildProfile, search, recent, getSession, getSessionEventsPage, stats, listSessionCatalogPage, listSessionCatalog, discoverSessions, sync, syncLocal, syncAndPush } = nativeBinding
 
+module.exports.nativeContractVersion = nativeContractVersion
+module.exports.nativeBuildProfile = nativeBuildProfile
+module.exports.search = search
+module.exports.recent = recent
+module.exports.getSession = getSession
+module.exports.getSessionEventsPage = getSessionEventsPage
+module.exports.stats = stats
+module.exports.listSessionCatalogPage = listSessionCatalogPage
+module.exports.listSessionCatalog = listSessionCatalog
+module.exports.discoverSessions = discoverSessions
+module.exports.sync = sync
+module.exports.syncLocal = syncLocal
 module.exports.syncAndPush = syncAndPush

package/npm/darwin-arm64/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-darwin-arm64`
+
+This is the **aarch64-apple-darwin** binary for `ai-hist-native`

package/npm/darwin-arm64/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ai-hist-native-darwin-arm64",
+  "version": "0.8.2",
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "main": "ai-hist-native.darwin-arm64.node",
+  "files": [
+    "ai-hist-native.darwin-arm64.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  }
+}

package/npm/darwin-x64/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-darwin-x64`
+
+This is the **x86_64-apple-darwin** binary for `ai-hist-native`

package/npm/darwin-x64/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ai-hist-native-darwin-x64",
+  "version": "0.8.2",
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "main": "ai-hist-native.darwin-x64.node",
+  "files": [
+    "ai-hist-native.darwin-x64.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  }
+}

package/npm/linux-arm64-gnu/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-linux-arm64-gnu`
+
+This is the **aarch64-unknown-linux-gnu** binary for `ai-hist-native`

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

@@ -0,0 +1,30 @@
+{
+  "name": "ai-hist-native-linux-arm64-gnu",
+  "version": "0.8.2",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "main": "ai-hist-native.linux-arm64-gnu.node",
+  "files": [
+    "ai-hist-native.linux-arm64-gnu.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  },
+  "libc": [
+    "glibc"
+  ]
+}

package/npm/linux-arm64-musl/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-linux-arm64-musl`
+
+This is the **aarch64-unknown-linux-musl** binary for `ai-hist-native`

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

@@ -0,0 +1,30 @@
+{
+  "name": "ai-hist-native-linux-arm64-musl",
+  "version": "0.8.2",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "main": "ai-hist-native.linux-arm64-musl.node",
+  "files": [
+    "ai-hist-native.linux-arm64-musl.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  },
+  "libc": [
+    "musl"
+  ]
+}

package/npm/linux-x64-gnu/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-linux-x64-gnu`
+
+This is the **x86_64-unknown-linux-gnu** binary for `ai-hist-native`

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

@@ -0,0 +1,30 @@
+{
+  "name": "ai-hist-native-linux-x64-gnu",
+  "version": "0.8.2",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "main": "ai-hist-native.linux-x64-gnu.node",
+  "files": [
+    "ai-hist-native.linux-x64-gnu.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  },
+  "libc": [
+    "glibc"
+  ]
+}

package/npm/linux-x64-musl/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-linux-x64-musl`
+
+This is the **x86_64-unknown-linux-musl** binary for `ai-hist-native`

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

@@ -0,0 +1,30 @@
+{
+  "name": "ai-hist-native-linux-x64-musl",
+  "version": "0.8.2",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "main": "ai-hist-native.linux-x64-musl.node",
+  "files": [
+    "ai-hist-native.linux-x64-musl.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  },
+  "libc": [
+    "musl"
+  ]
+}

package/npm/win32-x64-msvc/README.md

@@ -0,0 +1,3 @@
+# `ai-hist-native-win32-x64-msvc`
+
+This is the **x86_64-pc-windows-msvc** binary for `ai-hist-native`

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

@@ -0,0 +1,27 @@
+{
+  "name": "ai-hist-native-win32-x64-msvc",
+  "version": "0.8.2",
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "main": "ai-hist-native.win32-x64-msvc.node",
+  "files": [
+    "ai-hist-native.win32-x64-msvc.node"
+  ],
+  "description": "Mandatory Node-API engine for RelayHistory.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relayhistory.git",
+    "directory": "crates/ai-hist-napi"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-hist-native",
-  "version": "0.4.3",
-  "description": "Native (napi) binding for ai-hist — in-process sync + cloud push.",
+  "version": "0.8.2",
+  "description": "Mandatory Node-API engine for RelayHistory.",
   "main": "index.js",
   "types": "index.d.ts",
   "license": "MIT",
@@ -20,16 +20,18 @@
         "x86_64-unknown-linux-gnu",
         "aarch64-unknown-linux-gnu",
         "x86_64-unknown-linux-musl",
-        "aarch64-unknown-linux-musl"
+        "aarch64-unknown-linux-musl",
+        "x86_64-pc-windows-msvc"
       ]
     }
   },
   "files": [
     "index.js",
-    "index.d.ts"
+    "index.d.ts",
+    "npm"
   ],
   "engines": {
-    "node": ">= 18"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"
@@ -42,11 +44,12 @@
     "@napi-rs/cli": "^2.18.4"
   },
   "optionalDependencies": {
-    "ai-hist-native-darwin-arm64": "0.4.3",
-    "ai-hist-native-darwin-x64": "0.4.3",
-    "ai-hist-native-linux-x64-gnu": "0.4.3",
-    "ai-hist-native-linux-arm64-gnu": "0.4.3",
-    "ai-hist-native-linux-x64-musl": "0.4.3",
-    "ai-hist-native-linux-arm64-musl": "0.4.3"
+    "ai-hist-native-darwin-arm64": "0.8.2",
+    "ai-hist-native-darwin-x64": "0.8.2",
+    "ai-hist-native-linux-x64-gnu": "0.8.2",
+    "ai-hist-native-linux-arm64-gnu": "0.8.2",
+    "ai-hist-native-linux-x64-musl": "0.8.2",
+    "ai-hist-native-linux-arm64-musl": "0.8.2",
+    "ai-hist-native-win32-x64-msvc": "0.8.2"
   }
 }