ai-hist-native 0.11.0 → 0.13.0

package/index.d.ts

@@ -74,6 +74,70 @@ export interface SessionEventsPage {
   events: Array<NativeSessionEvent>
   nextCursor?: EventCursor
 }
+export interface NativeSessionToolCall {
+  id: number
+  source: string
+  sessionId: string
+  messageId?: string
+  toolUseId: string
+  name: string
+  target?: string
+  /**
+   * Stored provider arguments, unparsed. The SDK owns JSON parsing so an
+   * unreadable value cannot fail a whole page at the boundary.
+   */
+  argsJson?: string
+  isError?: boolean
+  tsMs?: number
+}
+export interface NativeSessionFileEdit {
+  id: number
+  source: string
+  sessionId: string
+  messageId?: string
+  toolUseId: string
+  filePath: string
+  toolName?: string
+  linesAdded?: number
+  linesRemoved?: number
+  /** Stored provider patch, unparsed, for the same reason as `args_json`. */
+  structuredPatchJson?: string
+  userModified?: boolean
+  tsMs?: number
+  gitBranch?: string
+  cwd?: string
+}
+/**
+ * Continuation for tool call and file edit pages. `tsMs` is optional because
+ * both tables order their undated rows last.
+ *
+ * Absent-or-`undefined` is how a caller says "inside the undated tail": an
+ * explicit JavaScript `null` cannot be converted to `i64` and fails at the
+ * boundary, so the SDK normalizes `null` to `undefined` before calling in.
+ */
+export interface EvidenceCursor {
+  tsMs?: number
+  id: number
+}
+export interface EvidencePageOptions {
+  dbPath?: string
+  limit?: number
+  after?: EvidenceCursor
+}
+export interface SessionToolCallsPage {
+  contractVersion: number
+  source: string
+  sessionId: string
+  toolCalls: Array<NativeSessionToolCall>
+  nextCursor?: EvidenceCursor
+}
+export interface SessionFileEditsPage {
+  contractVersion: number
+  source: string
+  sessionId: string
+  fileEdits: Array<NativeSessionFileEdit>
+  nextCursor?: EvidenceCursor
+}
 export interface SourceCount {
   source: string
   count: number
@@ -103,6 +167,15 @@ export declare function recent(options?: HistoryQueryOptions | undefined | null)
 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>
+/**
+ * One bounded page of recorded tool calls for one session.
+ *
+ * Both `source` and `sessionId` are required: provider session ids are not
+ * globally unique, so an id-only lookup could interleave two sessions.
+ */
+export declare function getSessionToolCallsPage(source: string, sessionId: string, options?: EvidencePageOptions | undefined | null): Promise<SessionToolCallsPage>
+/** One bounded page of recorded file edits for one session. */
+export declare function getSessionFileEditsPage(source: string, sessionId: string, options?: EvidencePageOptions | undefined | null): Promise<SessionFileEditsPage>
 /** Database statistics over already-indexed data. */
 export declare function stats(options?: StatsOptions | undefined | null): Promise<NativeStats>
 export interface CatalogSession {
@@ -173,6 +246,8 @@ export interface DiscoveryCounters {
   skippedUnchanged: number
   filesOpened: number
   bytesRead: number
+  providerQueries: number
+  recordsInspected: number
 }
 export interface SourceExemption {
   source: string
@@ -207,6 +282,7 @@ export interface HydrationEvidence {
   prompts: number
   events: number
   toolCalls: number
+  fileEdits: number
   relatedSessions: number
 }
 export interface HydrationDiagnostic {
@@ -221,6 +297,7 @@ export interface HydrateSessionResult {
   source: string
   sessionId: string
   status: string
+  capability: string
   discoveryState: string
   presence: string
   indexedThrough: HydrationIndexedThrough
@@ -230,6 +307,108 @@ export interface HydrateSessionResult {
 }
 /** Fully index one cataloged session without enumerating unrelated sessions. */
 export declare function hydrateSession(options: HydrateSessionOptions): Promise<HydrateSessionResult>
+export interface NativeSessionRelationship {
+  source: string
+  parentSessionId: string
+  childSessionId?: string
+  relationship: string
+  identityStatus: string
+  childAgentType?: string
+  childAgentName?: string
+  childModel?: string
+  spawnDepth?: number
+  evidenceKind: string
+  evidenceLocator?: string
+  evidenceRef?: string
+  childHasEvents: boolean
+  spawnedAtMs?: number
+  createdMs: number
+  relationshipUid: string
+}
+export interface NativeRelationshipCapabilities {
+  source: string
+  stableChildIdentity: string
+  recordsAgentType: boolean
+  recordsSpawnTime: boolean
+  recordsEvidenceLocator: boolean
+}
+export interface NativeRelationshipDiagnostic {
+  code: string
+  message: string
+  relationshipUid?: string
+}
+export interface NativeSessionRelationships {
+  contractVersion: number
+  source: string
+  sessionId: string
+  asParent: Array<NativeSessionRelationship>
+  asChild: Array<NativeSessionRelationship>
+  capabilities: NativeRelationshipCapabilities
+  diagnostics: Array<NativeRelationshipDiagnostic>
+}
+export interface NativeSessionTreeNode {
+  source: string
+  sessionId: string
+  depth: number
+  parentSessionId?: string
+  relationship?: NativeSessionRelationship
+  childCount: number
+  hasEvents: boolean
+  truncated: boolean
+}
+export interface NativeSessionTree {
+  contractVersion: number
+  source: string
+  rootSessionId: string
+  nodes: Array<NativeSessionTreeNode>
+  unlinked: Array<NativeSessionRelationship>
+  capabilities: NativeRelationshipCapabilities
+  diagnostics: Array<NativeRelationshipDiagnostic>
+  truncated: boolean
+  maxDepthReached: number
+}
+export interface RelationshipCursor {
+  spawnedAtMs?: number
+  relationshipUid: string
+}
+export interface NativeSessionChildrenPage {
+  children: Array<NativeSessionRelationship>
+  nextCursor?: RelationshipCursor
+}
+export interface RelationshipOptions {
+  source: string
+  sessionId: string
+  dbPath?: string
+}
+export interface SessionTreeOptions {
+  source: string
+  sessionId: string
+  dbPath?: string
+  maxDepth?: number
+  maxNodes?: number
+}
+export interface SessionChildrenPageOptions {
+  source: string
+  sessionId: string
+  dbPath?: string
+  limit?: number
+  after?: RelationshipCursor
+}
+/**
+ * Direct delegation relationships for one session, in both directions.
+ * A missing database is an empty result, not an error.
+ */
+export declare function getSessionRelationships(options: RelationshipOptions): Promise<NativeSessionRelationships>
+/**
+ * The complete descendant delegation tree for one session: pre-order,
+ * cycle-safe, and bounded by `maxDepth` / `maxNodes`.
+ */
+export declare function getSessionTree(options: SessionTreeOptions): Promise<NativeSessionTree>
+/**
+ * One bounded page of a session's direct children, in the same total order
+ * the tree traversal uses.
+ */
+export declare function getSessionChildrenPage(options: SessionChildrenPageOptions): Promise<NativeSessionChildrenPage>
 export interface SyncOptions {
   dbPath?: string
   scope?: string

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { nativeContractVersion, nativeBuildProfile, search, recent, getSession, getSessionEventsPage, stats, listSessionCatalogPage, listSessionCatalog, discoverSessions, hydrateSession, sync, syncLocal, syncAndPush } = nativeBinding
+const { nativeContractVersion, nativeBuildProfile, search, recent, getSession, getSessionEventsPage, getSessionToolCallsPage, getSessionFileEditsPage, stats, listSessionCatalogPage, listSessionCatalog, discoverSessions, hydrateSession, getSessionRelationships, getSessionTree, getSessionChildrenPage, sync, syncLocal, syncAndPush } = nativeBinding
 
 module.exports.nativeContractVersion = nativeContractVersion
 module.exports.nativeBuildProfile = nativeBuildProfile
@@ -318,11 +318,16 @@ module.exports.search = search
 module.exports.recent = recent
 module.exports.getSession = getSession
 module.exports.getSessionEventsPage = getSessionEventsPage
+module.exports.getSessionToolCallsPage = getSessionToolCallsPage
+module.exports.getSessionFileEditsPage = getSessionFileEditsPage
 module.exports.stats = stats
 module.exports.listSessionCatalogPage = listSessionCatalogPage
 module.exports.listSessionCatalog = listSessionCatalog
 module.exports.discoverSessions = discoverSessions
 module.exports.hydrateSession = hydrateSession
+module.exports.getSessionRelationships = getSessionRelationships
+module.exports.getSessionTree = getSessionTree
+module.exports.getSessionChildrenPage = getSessionChildrenPage
 module.exports.sync = sync
 module.exports.syncLocal = syncLocal
 module.exports.syncAndPush = syncAndPush

package/npm/darwin-arm64/package.json

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

package/npm/darwin-x64/package.json

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

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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-hist-native",
-  "version": "0.11.0",
+  "version": "0.13.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.11.0",
-    "ai-hist-native-darwin-x64": "0.11.0",
-    "ai-hist-native-linux-x64-gnu": "0.11.0",
-    "ai-hist-native-linux-arm64-gnu": "0.11.0",
-    "ai-hist-native-linux-x64-musl": "0.11.0",
-    "ai-hist-native-linux-arm64-musl": "0.11.0",
-    "ai-hist-native-win32-x64-msvc": "0.11.0"
+    "ai-hist-native-darwin-arm64": "0.13.0",
+    "ai-hist-native-darwin-x64": "0.13.0",
+    "ai-hist-native-linux-x64-gnu": "0.13.0",
+    "ai-hist-native-linux-arm64-gnu": "0.13.0",
+    "ai-hist-native-linux-x64-musl": "0.13.0",
+    "ai-hist-native-linux-arm64-musl": "0.13.0",
+    "ai-hist-native-win32-x64-msvc": "0.13.0"
   }
 }