dsh-plugin-sessiongraph-native 0.1.22 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CC ZHAO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.22",
+  "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",
@@ -44,18 +44,18 @@
     "access": "public",
     "provenance": false
   },
-  "scripts": {
-    "build": "tsc -b",
-    "build:native": "./build-native.sh"
-  },
   "devDependencies": {
     "@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",
+    "build:native": "./build-native.sh"
   }
-}
+}