ai-hist-native 0.20.0 → 0.21.0

package/index.d.ts

@@ -71,6 +71,29 @@ export interface NativeSessionEvent {
   model?: string
   tokenJson?: string
   eventUid: string
+  /**
+   * Per-tool-result fidelity. Null on every row that is not a tool result,
+   * and on a tool-result row whose provider does not record the fact.
+   */
+  toolUseId?: string
+  /** Raw UTF-8 byte length of the provider's result payload. */
+  payloadBytes?: number
+  /** True when the harness had already truncated the payload. */
+  payloadTruncated?: boolean
+  /** First 16 hex characters of the payload's sha256. */
+  payloadHash?: string
+  /** n-th result recorded for this `toolUseId`, from zero. */
+  callIndex?: number
+  /** Position of this result in the transcript's tool-result order. */
+  eventIndex?: number
+  /** `running` / `completed` / `errored` / `cancelled` / `unknown`. */
+  resultStatus?: string
+  /** `tool_result` / `subagent_notification` / `function_call_output`. */
+  eventSource?: string
+  /** Which provider signal set the error. */
+  errorSignal?: string
+  subagentSessionId?: string
+  agentId?: string
   requestId?: string
   stopReason?: string
   agentVersion?: string
@@ -142,6 +165,49 @@ export interface EvidencePageOptions {
   limit?: number
   after?: EvidenceCursor
 }
+export interface NativeSessionUserTurnBlock {
+  /** `text` or `tool_result`. */
+  kind: string
+  toolUseId?: string
+  /**
+   * Measured payload bytes when the parser recorded them, otherwise the
+   * UTF-8 length of the stored text.
+   */
+  byteLen: number
+  /**
+   * True when the result is known to have failed, false when it is known
+   * to have succeeded, null when the provider has not said.
+   */
+  isError?: boolean
+}
+export interface NativeSessionUserTurn {
+  id: number
+  source: string
+  sessionId: string
+  messageId?: string
+  /**
+   * The nearest messages recorded either side of this turn, from either
+   * side of the conversation. Null only when the session recorded no named
+   * message on that side; an event the provider left unnamed is passed
+   * over rather than nulling the field.
+   */
+  precedingMessageId?: string
+  followingMessageId?: string
+  tsMs: number
+  blocks: Array<NativeSessionUserTurnBlock>
+}
+export interface UserTurnsPageOptions {
+  dbPath?: string
+  limit?: number
+  after?: EventCursor
+}
+export interface SessionUserTurnsPage {
+  contractVersion: number
+  source: string
+  sessionId: string
+  userTurns: Array<NativeSessionUserTurn>
+  nextCursor?: EventCursor
+}
 export interface SessionToolCallsPage {
   contractVersion: number
   source: string
@@ -203,6 +269,15 @@ export declare function getSessionEventsPage(sessionId: string, options?: Events
  * 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 user turns for one session, oldest first.
+ *
+ * Each turn carries the ordered blocks the provider attached to one user
+ * message: the human's own text and the tool results that came back with it,
+ * with the measured payload size of each. Computed from `session_events`
+ * rather than a table of its own, so it cannot disagree with the transcript.
+ */
+export declare function getSessionUserTurnsPage(source: string, sessionId: string, options?: UserTurnsPageOptions | undefined | null): Promise<SessionUserTurnsPage>
 /** 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. */
@@ -373,6 +448,7 @@ export interface NativeSessionRelationship {
   spawnedAtMs?: number
   createdMs: number
   relationshipUid: string
+  originSessionId?: string
 }
 export interface NativeRelationshipCapabilities {
   source: string
@@ -392,6 +468,7 @@ export interface NativeSessionRelationships {
   sessionId: string
   asParent: Array<NativeSessionRelationship>
   asChild: Array<NativeSessionRelationship>
+  continuity: Array<NativeSessionRelationship>
   capabilities: NativeRelationshipCapabilities
   diagnostics: Array<NativeRelationshipDiagnostic>
 }
@@ -435,6 +512,11 @@ export interface SessionTreeOptions {
   dbPath?: string
   maxDepth?: number
   maxNodes?: number
+  /**
+   * Which edges the walk follows. Omitted means delegation only, which is
+   * what every caller got before continuity existed.
+   */
+  relationshipKinds?: Array<string>
 }
 export interface SessionChildrenPageOptions {
   source: string
@@ -442,6 +524,7 @@ export interface SessionChildrenPageOptions {
   dbPath?: string
   limit?: number
   after?: RelationshipCursor
+  relationshipKinds?: Array<string>
 }
 /**
  * Direct delegation relationships for one session, in both directions.

package/index.js

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

package/npm/darwin-arm64/package.json

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

package/npm/darwin-x64/package.json

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

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

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

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

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

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

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

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

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

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

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

package/package.json

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