ai-hist-native 0.12.0 → 0.13.0

package/index.d.ts

@@ -246,6 +246,8 @@ export interface DiscoveryCounters {
   skippedUnchanged: number
   filesOpened: number
   bytesRead: number
+  providerQueries: number
+  recordsInspected: number
 }
 export interface SourceExemption {
   source: string
@@ -280,6 +282,7 @@ export interface HydrationEvidence {
   prompts: number
   events: number
   toolCalls: number
+  fileEdits: number
   relatedSessions: number
 }
 export interface HydrationDiagnostic {
@@ -294,6 +297,7 @@ export interface HydrateSessionResult {
   source: string
   sessionId: string
   status: string
+  capability: string
   discoveryState: string
   presence: string
   indexedThrough: HydrationIndexedThrough
@@ -303,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, getSessionToolCallsPage, getSessionFileEditsPage, 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
@@ -325,6 +325,9 @@ 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.12.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.12.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.12.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.12.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.12.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.12.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.12.0",
+  "version": "0.13.0",
   "os": [
     "win32"
   ],

package/package.json

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