dsh-plugin-sessiongraph-service 0.2.0 → 0.3.0

package/lib/index.d.ts

@@ -19,10 +19,11 @@ import type { SessiongraphIndexer, SessiongraphIndexOptions, SessiongraphIndexRe
 export { assertNever } from './assert.ts';
 export { SessiongraphIndexerId, SessiongraphSessionId, SessiongraphStoreId } from './brand.ts';
 export { ENTRY_FTS_TABLE, ENTRY_TABLE, INDEX_RELATIVE_PATH, META_DISCOVERED, META_FAILED, META_INDEXED_AT, META_SCHEMA_VERSION, SCHEMA_STATEMENTS, SCHEMA_VERSION, SESSION_TABLE, } from './schema.ts';
+export { PANEL_CODEX_SYNC_KEY, PANEL_FILE_NAME } from './panel.ts';
 export { highlightTerms, isCjk, matchExpression, tokenize } from './tokenize.ts';
 export { SessiongraphError } from './types.ts';
-export type { SessiongraphEntry, SessiongraphEntryKind, SessiongraphErrorCode, SessiongraphEventRequest, SessiongraphEventResult, SessiongraphEventTraceResult, SessiongraphHit, SessiongraphIndexer, SessiongraphIndexOptions, SessiongraphIndexReport, SessiongraphOperation, SessiongraphRawEvent, SessiongraphRawEventSummary, SessiongraphRequest, SessiongraphRequestBase, SessiongraphResult, SessiongraphResultFor, SessiongraphSearchRequest, SessiongraphSearchResult, SessiongraphService, SessiongraphSessionRequest, SessiongraphSessionResult, SessiongraphSessionSummary, SessiongraphSessionTraceResult, SessiongraphStatusRequest, SessiongraphStatusResult, SessiongraphStoreProvider, SessiongraphTimelineRequest, SessiongraphTimelineResult, SessiongraphTraceNode, SessiongraphTraceRequest, SessiongraphTraceResult, SessiongraphWorkspaceStat, SessiongraphWorkspacesRequest, SessiongraphWorkspacesResult, } from './types.ts';
-export { SESSIONGRAPH_ENTRY_KINDS, SESSIONGRAPH_OPERATIONS } from './types.ts';
+export type { SessiongraphEntry, SessiongraphEntryKind, SessiongraphErrorCode, SessiongraphEventRequest, SessiongraphEventResult, SessiongraphEventTraceResult, SessiongraphHit, SessiongraphIndexer, SessiongraphIndexOptions, SessiongraphIndexReport, SessiongraphOperation, SessiongraphRawEvent, SessiongraphRawEventSummary, SessiongraphRequest, SessiongraphRequestBase, SessiongraphResult, SessiongraphResultFor, SessiongraphSearchRequest, SessiongraphSearchResult, SessiongraphService, SessiongraphSessionRequest, SessiongraphSessionResult, SessiongraphSessionSummary, SessiongraphSessionTraceResult, SessiongraphSource, SessiongraphStatusRequest, SessiongraphStatusResult, SessiongraphStoreProvider, SessiongraphTimelineRequest, SessiongraphTimelineResult, SessiongraphTraceNode, SessiongraphTraceRequest, SessiongraphTraceResult, SessiongraphWorkspaceStat, SessiongraphWorkspacesRequest, SessiongraphWorkspacesResult, } from './types.ts';
+export { SESSIONGRAPH_ENTRY_KINDS, SESSIONGRAPH_OPERATIONS, SESSIONGRAPH_SOURCES } from './types.ts';
 /**
  * `ctx.sessiongraph`. Holds the store and indexer reservations; selection reads them per call so a
  * provider that unloads mid-session stops serving without leaving a stale route behind.

package/lib/index.js

@@ -21,9 +21,10 @@ import { SessiongraphError } from "./types.js";
 export { assertNever } from "./assert.js";
 export { SessiongraphIndexerId, SessiongraphSessionId, SessiongraphStoreId } from "./brand.js";
 export { ENTRY_FTS_TABLE, ENTRY_TABLE, INDEX_RELATIVE_PATH, META_DISCOVERED, META_FAILED, META_INDEXED_AT, META_SCHEMA_VERSION, SCHEMA_STATEMENTS, SCHEMA_VERSION, SESSION_TABLE, } from "./schema.js";
+export { PANEL_CODEX_SYNC_KEY, PANEL_FILE_NAME } from "./panel.js";
 export { highlightTerms, isCjk, matchExpression, tokenize } from "./tokenize.js";
 export { SessiongraphError } from "./types.js";
-export { SESSIONGRAPH_ENTRY_KINDS, SESSIONGRAPH_OPERATIONS } from "./types.js";
+export { SESSIONGRAPH_ENTRY_KINDS, SESSIONGRAPH_OPERATIONS, SESSIONGRAPH_SOURCES } from "./types.js";
 /**
  * `ctx.sessiongraph`. Holds the store and indexer reservations; selection reads them per call so a
  * provider that unloads mid-session stops serving without leaving a stale route behind.

package/lib/panel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The one file the settings panel and the indexer both know about.
+ *
+ * `panel.json` lives inside an index root and holds choices a human made in the settings page. It is
+ * **not** an index artifact: nothing in it describes indexed data, it is rewritten whole on every
+ * save, and a missing or unreadable file means "use the configured value" rather than an error — a
+ * broken panel must never stop an index run.
+ *
+ * Two packages read it for different members, which is why the name lives here rather than in either
+ * of them: `tool` owns the HTTP surface and writes the document, while `sessions` reads
+ * `codexSync` on every run because that choice decides whether Codex history is part of the corpus.
+ * A second spelling of the filename would let the panel save a choice the indexer never sees.
+ * @module dsh-plugin-sessiongraph-service/panel
+ */
+/** Name of the settings document inside an index root. */
+export declare const PANEL_FILE_NAME = "panel.json";
+/**
+ * The member of `panel.json` that decides whether Codex history is indexed.
+ *
+ * Absent means "whatever the plugin configuration says": a user who never opened the panel keeps the
+ * configured default, and only an explicit save stores a value. Deliberately a bare optional boolean
+ * rather than a tri-state — the configuration already owns "default", so the file only ever records
+ * a human's deviation from it.
+ */
+export declare const PANEL_CODEX_SYNC_KEY = "codexSync";
+//# sourceMappingURL=panel.d.ts.map

package/lib/panel.js

@@ -0,0 +1,26 @@
+/**
+ * The one file the settings panel and the indexer both know about.
+ *
+ * `panel.json` lives inside an index root and holds choices a human made in the settings page. It is
+ * **not** an index artifact: nothing in it describes indexed data, it is rewritten whole on every
+ * save, and a missing or unreadable file means "use the configured value" rather than an error — a
+ * broken panel must never stop an index run.
+ *
+ * Two packages read it for different members, which is why the name lives here rather than in either
+ * of them: `tool` owns the HTTP surface and writes the document, while `sessions` reads
+ * `codexSync` on every run because that choice decides whether Codex history is part of the corpus.
+ * A second spelling of the filename would let the panel save a choice the indexer never sees.
+ * @module dsh-plugin-sessiongraph-service/panel
+ */
+/** Name of the settings document inside an index root. */
+export const PANEL_FILE_NAME = 'panel.json';
+/**
+ * The member of `panel.json` that decides whether Codex history is indexed.
+ *
+ * Absent means "whatever the plugin configuration says": a user who never opened the panel keeps the
+ * configured default, and only an explicit save stores a value. Deliberately a bare optional boolean
+ * rather than a tri-state — the configuration already owns "default", so the file only ever records
+ * a human's deviation from it.
+ */
+export const PANEL_CODEX_SYNC_KEY = 'codexSync';
+//# sourceMappingURL=panel.js.map

package/lib/schema.d.ts

@@ -14,8 +14,12 @@
  * v2 stores the FTS index contentless (`content=''`): FTS5's default build keeps a copy of every
  * indexed column in a `_content` shadow table, which on a real corpus was 67MB of a 174MB file
  * holding a token stream that can always be recomputed from `entry.text`.
+ *
+ * v3 records which harness wrote a session (`session.source`). The first version indexed only DSH's
+ * own logs, so the column is absent rather than defaulted; a v3 row carries `'dsh'` or `'codex'` and
+ * a store that cannot name the origin refuses the file instead of labelling every hit "dsh".
  */
-export declare const SCHEMA_VERSION = 2;
+export declare const SCHEMA_VERSION = 3;
 /** Relative path of the index file inside an index root. */
 export declare const INDEX_RELATIVE_PATH = "index.db";
 /** One session, keyed by its harness session id. */

package/lib/schema.js

@@ -14,8 +14,12 @@
  * v2 stores the FTS index contentless (`content=''`): FTS5's default build keeps a copy of every
  * indexed column in a `_content` shadow table, which on a real corpus was 67MB of a 174MB file
  * holding a token stream that can always be recomputed from `entry.text`.
+ *
+ * v3 records which harness wrote a session (`session.source`). The first version indexed only DSH's
+ * own logs, so the column is absent rather than defaulted; a v3 row carries `'dsh'` or `'codex'` and
+ * a store that cannot name the origin refuses the file instead of labelling every hit "dsh".
  */
-export const SCHEMA_VERSION = 2;
+export const SCHEMA_VERSION = 3;
 /** Relative path of the index file inside an index root. */
 export const INDEX_RELATIVE_PATH = 'index.db';
 /** One session, keyed by its harness session id. */
@@ -43,6 +47,7 @@ export const SCHEMA_STATEMENTS = [
    )`,
     `CREATE TABLE IF NOT EXISTS ${SESSION_TABLE} (
      id TEXT PRIMARY KEY,
+     source TEXT NOT NULL,
      workspace TEXT NOT NULL,
      title TEXT,
      created_at INTEGER NOT NULL,

package/lib/types.d.ts

@@ -31,6 +31,18 @@ export type SessiongraphOperation = (typeof SESSIONGRAPH_OPERATIONS)[number];
 export declare const SESSIONGRAPH_ENTRY_KINDS: readonly ["user", "assistant", "tool", "title"];
 /** One entry kind. */
 export type SessiongraphEntryKind = (typeof SESSIONGRAPH_ENTRY_KINDS)[number];
+/**
+ * Which agent harness wrote a session log.
+ *
+ * `dsh` is this host's own store under `~/.dsh/sessions`; `codex` is OpenAI Codex's rollout log
+ * under `~/.codex`. The value is stored per session, not per index, because one index deliberately
+ * holds both and a hit that cannot say where it came from makes a caller read the wrong file. It is
+ * a closed set rather than a free-form string: an unknown origin is a bug in the indexer, and
+ * widening this list is how a new harness becomes queryable.
+ */
+export declare const SESSIONGRAPH_SOURCES: readonly ["dsh", "codex"];
+/** One session source. */
+export type SessiongraphSource = (typeof SESSIONGRAPH_SOURCES)[number];
 /** Error codes the seam raises, so a consumer can distinguish "no index" from "bad request". */
 export type SessiongraphErrorCode = 'SESSIONGRAPH_UNAVAILABLE' | 'SESSIONGRAPH_CONFLICT' | 'SESSIONGRAPH_INVALID_PROVIDER' | 'SESSIONGRAPH_INVALID_REQUEST' | 'SESSIONGRAPH_NOT_FOUND' | 'SESSIONGRAPH_CORRUPT' | 'SESSIONGRAPH_IO';
 /** The single error type crossing the seam. */
@@ -54,6 +66,14 @@ export interface SessiongraphSearchRequest extends SessiongraphRequestBase {
     query: string;
     /** Restrict to one workspace (exact `cwd`), or a path prefix when it ends without a trailing slash. */
     workspace?: string;
+    /**
+     * Restrict to sessions one harness wrote.
+     *
+     * An index holds DSH's own logs and Codex's rollout logs side by side, and the two answer different
+     * questions: "what did I ask DSH about this repo" and "what did I ask Codex about it". Absent means
+     * every source, which is the right default for a cross-harness sweep.
+     */
+    source?: SessiongraphSource;
     /** Only entries at or after this epoch-millisecond timestamp. */
     after?: number;
     /** Only entries at or before this epoch-millisecond timestamp. */
@@ -84,6 +104,8 @@ export interface SessiongraphSearchRequest extends SessiongraphRequestBase {
 /** One matched entry, with enough context to recognize it without a second query. */
 export interface SessiongraphHit {
     sessionId: SessiongraphSessionId;
+    /** Which harness wrote the session this hit belongs to. */
+    source: SessiongraphSource;
     /** Session title, when the session ever produced one. */
     title: string | undefined;
     /** The session's working directory. */
@@ -119,6 +141,8 @@ export interface SessiongraphSearchResult {
 /** A session's metadata, as the timeline and session operations report it. */
 export interface SessiongraphSessionSummary {
     sessionId: SessiongraphSessionId;
+    /** Which harness wrote this session's log. */
+    source: SessiongraphSource;
     title: string | undefined;
     workspace: string;
     /** Epoch milliseconds of the session's first event. */
@@ -172,6 +196,8 @@ export interface SessiongraphTimelineRequest extends SessiongraphRequestBase {
     operation: 'timeline';
     /** Restrict to one workspace, or a path prefix when it ends without a trailing slash. */
     workspace?: string;
+    /** Restrict to one harness's sessions. Absent means every source. */
+    source?: SessiongraphSource;
     /** Only sessions whose last event is at or after this epoch-millisecond timestamp. */
     after?: number;
     /** Only sessions whose first event is at or before this epoch-millisecond timestamp. */
@@ -191,6 +217,8 @@ export interface SessiongraphTimelineResult {
 /** Enumerate the workspaces the index covers. */
 export interface SessiongraphWorkspacesRequest extends SessiongraphRequestBase {
     operation: 'workspaces';
+    /** Restrict the census to one harness's sessions. Absent means every source. */
+    source?: SessiongraphSource;
     /** Maximum workspaces to return, most recently active first. */
     limit: number;
     /** Workspaces to skip, for paging; follows the most-recently-active-first order. */

package/lib/types.js

@@ -26,6 +26,16 @@ export const SESSIONGRAPH_OPERATIONS = ['search', 'session', 'event', 'trace', '
  * is a session title, kept as its own kind so a title match is recognizable in the hit list.
  */
 export const SESSIONGRAPH_ENTRY_KINDS = ['user', 'assistant', 'tool', 'title'];
+/**
+ * Which agent harness wrote a session log.
+ *
+ * `dsh` is this host's own store under `~/.dsh/sessions`; `codex` is OpenAI Codex's rollout log
+ * under `~/.codex`. The value is stored per session, not per index, because one index deliberately
+ * holds both and a hit that cannot say where it came from makes a caller read the wrong file. It is
+ * a closed set rather than a free-form string: an unknown origin is a bug in the indexer, and
+ * widening this list is how a new harness becomes queryable.
+ */
+export const SESSIONGRAPH_SOURCES = ['dsh', 'codex'];
 /** The single error type crossing the seam. */
 export class SessiongraphError extends Error {
     code;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-sessiongraph-service",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Service definition for the DeepSeek Harness session-graph seam (ctx.sessiongraph) — a store-provider and indexer-provider registry over local conversation history, plus the normalized query vocabulary the model-facing tool speaks",
   "keywords": [
     "dsh",