dsh-plugin-sessiongraph-native 0.1.21 → 0.2.0

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Loader for the native Rust index kernel.
+ * Loader for the native Rust kernel: the index writer and the query engine.
  *
  * The kernel is a napi-rs `cdylib` (`sessiongraph-core.<platform>-<arch>.node`) built from
  * `crates/sessiongraph-core` and copied beside this module by `build-native.sh`. Nothing here may
@@ -73,6 +73,64 @@ export interface NativeIndexReport {
     /** Wall-clock duration of the run, milliseconds. */
     elapsedMs: number;
 }
+/**
+ * One request to the native query kernel.
+ *
+ * Field names are snake_case because the Rust `QueryRequest` declares them so; the numeric fields are
+ * `number` (never BigInt) because napi maps `f64` to a JS number. The seam's request shape uses
+ * camelCase and different names (`after`/`before`), so the store's adapter translates.
+ */
+export interface NativeQueryRequest {
+    /** Directory holding the index (`<indexRoot>/index.db`). */
+    index_root: string;
+    /** `search | session | event | trace | timeline | workspaces | status`. */
+    operation: string;
+    /** Search text. */
+    query?: string;
+    /** Full session id, or a prefix identifying exactly one session. */
+    session_id?: string;
+    /** Event sequence number (event; trace's event shape). */
+    seq?: number;
+    /** Page size. */
+    limit?: number;
+    /** Rows to skip. */
+    offset?: number;
+    /** Raw events before the target (event). */
+    window_before?: number;
+    /** Raw events after the target (event). */
+    window_after?: number;
+    /** Maximum descendant depth (trace's session shape). */
+    depth?: number;
+    /** Workspace filter (exact, or a prefix when it ends with `/`). */
+    workspace?: string;
+    /** Lower epoch-millisecond bound. */
+    since?: number;
+    /** Upper epoch-millisecond bound. */
+    until?: number;
+    /** Entry kinds to include (search). */
+    kinds?: string[];
+    /** One hit per session (default true). */
+    dedupe_by_session?: boolean;
+    /** Largest snippet, in UTF-16 code units (the store's `maxSnippetChars`, default 240). */
+    max_snippet_chars?: number;
+}
+/**
+ * One answer from the native query kernel.
+ *
+ * The result crosses as a JSON string in `payloadJson`: a raw event can be tens of kilobytes, and one
+ * `JSON.parse` costs less than converting every field across the napi boundary. A failure is reported
+ * as `ok: false` with the seam's error code rather than thrown, so the caller can fall back.
+ */
+export interface NativeQueryResponse {
+    /** Whether the operation ran. */
+    ok: boolean;
+    /** Complete result JSON, or an empty string on failure. */
+    payload_json: string;
+    /** `SESSIONGRAPH_*` code when `ok` is false. */
+    error_code?: string;
+    /** Human-readable failure reason when `ok` is false. */
+    error_message?: string;
+}
 /** The loaded native module's surface. */
 export interface NativeKernel {
     /**
@@ -86,6 +144,16 @@ export interface NativeKernel {
      * @throws when the index cannot be written; parse failures are reported, not thrown.
      */
     indexSessions(options: NativeIndexOptions): Promise<NativeIndexReport>;
+    /**
+     * Answer one query, off the JavaScript thread.
+     *
+     * Optional on the interface because a kernel built before the query export exists still loads:
+     * `typeof kernel.query === 'function'` is the store's probe, and a build without it falls back to
+     * the TypeScript store exactly as a missing binary does.
+     * @param request - the snake_case request the Rust side declares.
+     * @returns the response envelope, `ok: false` carrying any failure.
+     */
+    query?(request: NativeQueryRequest): Promise<NativeQueryResponse>;
 }
 /**
  * Load the native kernel, or report that this machine has none.

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * Loader for the native Rust index kernel.
+ * Loader for the native Rust kernel: the index writer and the query engine.
  *
  * The kernel is a napi-rs `cdylib` (`sessiongraph-core.<platform>-<arch>.node`) built from
  * `crates/sessiongraph-core` and copied beside this module by `build-native.sh`. Nothing here may

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-sessiongraph-native",
-  "version": "0.1.21",
+  "version": "0.2.0",
   "description": "Native Rust index kernel for DeepSeek Harness sessiongraph — scan, multi-frame zstd decode, JSONL parse and SQLite write, exposed to Node through napi-rs",
   "keywords": [
     "dsh",
@@ -48,11 +48,11 @@
     "@types/node": "^22.10.0"
   },
   "optionalDependencies": {
-    "dsh-plugin-sessiongraph-indexer-darwin-arm64": "0.1.21",
-    "dsh-plugin-sessiongraph-indexer-darwin-x64": "0.1.21",
-    "dsh-plugin-sessiongraph-indexer-linux-x64-gnu": "0.1.21",
-    "dsh-plugin-sessiongraph-indexer-linux-arm64-gnu": "0.1.21",
-    "dsh-plugin-sessiongraph-indexer-win32-x64-msvc": "0.1.21"
+    "dsh-plugin-sessiongraph-indexer-darwin-arm64": "0.2.0",
+    "dsh-plugin-sessiongraph-indexer-darwin-x64": "0.2.0",
+    "dsh-plugin-sessiongraph-indexer-linux-x64-gnu": "0.2.0",
+    "dsh-plugin-sessiongraph-indexer-linux-arm64-gnu": "0.2.0",
+    "dsh-plugin-sessiongraph-indexer-win32-x64-msvc": "0.2.0"
   },
   "scripts": {
     "build": "tsc -b",