dsh-plugin-sessiongraph-service 0.1.21 → 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, SessiongraphHit, SessiongraphIndexer, SessiongraphIndexOptions, SessiongraphIndexReport, SessiongraphOperation, SessiongraphRequest, SessiongraphRequestBase, SessiongraphResult, SessiongraphResultFor, SessiongraphSearchRequest, SessiongraphSearchResult, SessiongraphService, SessiongraphSessionRequest, SessiongraphSessionResult, SessiongraphSessionSummary, SessiongraphStatusRequest, SessiongraphStatusResult, SessiongraphStoreProvider, SessiongraphTimelineRequest, SessiongraphTimelineResult, 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

@@ -9,8 +9,16 @@
  * @module dsh-plugin-sessiongraph-service/types
  */
 import type { SessiongraphIndexerId, SessiongraphSessionId, SessiongraphStoreId } from './brand.ts';
-/** Every query operation the seam answers. */
-export declare const SESSIONGRAPH_OPERATIONS: readonly ["search", "session", "timeline", "workspaces", "status"];
+/**
+ * Every query operation the seam answers.
+ *
+ * `event` and `trace` were added when the model-facing surface collapsed from two tools into one:
+ * the built-in session tools could read a single unabridged event and follow replacement/citation
+ * relationships, and a replacement that dropped those answers would be a downgrade rather than a
+ * swap. An index run is deliberately **not** here — it writes, so the tool routes it through
+ * `Sessiongraph.index()` instead of pretending a query provider can build an index.
+ */
+export declare const SESSIONGRAPH_OPERATIONS: readonly ["search", "session", "event", "trace", "timeline", "workspaces", "status"];
 /** One query operation. */
 export type SessiongraphOperation = (typeof SESSIONGRAPH_OPERATIONS)[number];
 /**
@@ -23,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. */
@@ -46,12 +66,36 @@ 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. */
     before?: number;
     /** Restrict to these entry kinds. Absent means every kind. */
     kinds?: readonly SessiongraphEntryKind[];
+    /**
+     * Restrict the search to one session: a full id, or a prefix long enough to identify exactly one.
+     *
+     * A prefix that matches several sessions raises `SESSIONGRAPH_INVALID_REQUEST` rather than
+     * guessing — a search silently answered from the wrong conversation is worse than a refusal. This
+     * is what replaces the built-in `session_event_search`, which needed its own tool for it.
+     */
+    sessionId?: string;
+    /**
+     * Return at most one hit per session (the strongest), default `true`.
+     *
+     * The built-in cross-session search answered one hit per session, and a caller paging through a
+     * verbatim log usually wants breadth across conversations, not ten matches from one. Callers that
+     * want every entry (a single-session sweep) turn it off.
+     */
+    dedupeBySession?: boolean;
     /** Maximum hits to return. */
     limit: number;
     /** Hits to skip, for paging. */
@@ -60,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. */
@@ -81,7 +127,13 @@ export interface SessiongraphHit {
 export interface SessiongraphSearchResult {
     operation: 'search';
     hits: SessiongraphHit[];
-    /** Total entries matching the query across the whole store, before `limit`/`offset`. */
+    /**
+     * How many results matched before `limit`/`offset` — counted in the same unit the hits use.
+     *
+     * With `dedupeBySession` on (the default) that is **sessions**, because the hits are one per
+     * session; counting entries there would make `truncated` permanently true and paging incoherent.
+     * With it off, it is entries.
+     */
     total: number;
     /** True when `total` exceeded `limit + offset`, or when a snippet was clipped. */
     truncated: boolean;
@@ -89,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. */
@@ -142,12 +196,16 @@ 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. */
     before?: number;
     /** Maximum sessions to return, newest first. */
     limit: number;
+    /** Sessions to skip, for paging; follows the timeline's newest-first order. */
+    offset?: number;
 }
 /** Answer to a timeline request. */
 export interface SessiongraphTimelineResult {
@@ -159,8 +217,12 @@ 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. */
+    offset?: number;
 }
 /** One workspace's coverage. */
 export interface SessiongraphWorkspaceStat {
@@ -208,12 +270,120 @@ export interface SessiongraphStatusResult {
     /** Bytes the index file occupies on disk. */
     bytes: number;
 }
+/**
+ * One raw event, reduced to the fields that let a reader orient around a target.
+ *
+ * The window around an event is answered as summaries rather than full payloads: a caller asking
+ * "what came before this" wants the shape of the conversation, not megabytes of tool output.
+ */
+export interface SessiongraphRawEventSummary {
+    /** Event sequence number inside its session. */
+    seq: number;
+    /** Event timestamp, epoch milliseconds. */
+    time: number;
+    /** Event type as the log records it (`tool/call`, `assistant/message`, …). */
+    type: string;
+}
+/** One event exactly as the session log holds it, with no clipping applied. */
+export interface SessiongraphRawEvent {
+    /** Event sequence number inside its session. */
+    seq: number;
+    /** Event timestamp, epoch milliseconds. */
+    time: number;
+    /** Event type as the log records it. */
+    type: string;
+    /**
+     * The event's own `data` payload, verbatim. Opaque to this seam on purpose: the log's event
+     * vocabulary belongs to `dsh-session`, and re-declaring it here would drift.
+     */
+    data: unknown;
+}
+/**
+ * Read one unabridged event, plus an optional window of neighbouring events.
+ *
+ * This is what replaces the built-in `session_event_read`. It reads the source log directly rather
+ * than the index, because the index stores semantic text clipped to a per-entry cap and this answer
+ * must be the original bytes.
+ */
+export interface SessiongraphEventRequest extends SessiongraphRequestBase {
+    operation: 'event';
+    /** Full session id, or a prefix long enough to identify exactly one session. */
+    sessionId: string;
+    /** Sequence number of the target event. */
+    seq: number;
+    /** Raw events to include immediately before the target. Omitted means none. */
+    windowBefore?: number;
+    /** Raw events to include immediately after the target. Omitted means none. */
+    windowAfter?: number;
+}
+/** Answer to an event request. */
+export interface SessiongraphEventResult {
+    operation: 'event';
+    session: SessiongraphSessionSummary;
+    /** The target event, unabridged. */
+    event: SessiongraphRawEvent;
+    /** Neighbours before the target, oldest first. */
+    before: SessiongraphRawEventSummary[];
+    /** Neighbours after the target, oldest first. */
+    after: SessiongraphRawEventSummary[];
+}
+/** One node of a recursive descendant tree. */
+export interface SessiongraphTraceNode {
+    session: SessiongraphSessionSummary;
+    descendants: SessiongraphTraceNode[];
+}
+/**
+ * Follow session lineage, or one event's replacement and citation relationships.
+ *
+ * `seq` selects the shape: present means "trace this event", absent means "trace this session".
+ * Both live in one operation because they share the only other input (`sessionId`) and because a
+ * second tool would cost permanent schema tokens for a question asked rarely.
+ */
+export interface SessiongraphTraceRequest extends SessiongraphRequestBase {
+    operation: 'trace';
+    /** Full session id, or a prefix long enough to identify exactly one session. */
+    sessionId: string;
+    /** Given → trace one event inside the session; omitted → trace the session's lineage. */
+    seq?: number;
+    /** Maximum descendant depth to walk. Omitted means the whole tree. */
+    depth?: number;
+}
+/** A session's ancestor chain and descendant tree. */
+export interface SessiongraphSessionTraceResult {
+    operation: 'trace';
+    kind: 'session';
+    target: SessiongraphSessionSummary;
+    /** Ancestors, nearest first. */
+    ancestors: SessiongraphSessionSummary[];
+    descendants: SessiongraphTraceNode[];
+    /**
+     * False when the walk stopped early — a depth limit was hit, or a parent the index does not hold.
+     * A caller must be able to tell "this is the root" from "I gave up looking".
+     */
+    complete: boolean;
+}
+/** One event's positional replacements and the source events it cites. */
+export interface SessiongraphEventTraceResult {
+    operation: 'trace';
+    kind: 'event';
+    session: SessiongraphSessionSummary;
+    /** The target event, reduced to its identity. */
+    event: SessiongraphRawEventSummary;
+    /** Sequence numbers that replaced this event, following the chain outward. */
+    replacedBy: number[];
+    /** Sequence numbers this event shadowed. */
+    shadowedSeqs: number[];
+    /** Sequence numbers this event cites as sources (a tool result citing its call, for instance). */
+    sourceEventSeqs: number[];
+}
+/** Either trace shape, discriminated on `kind`. */
+export type SessiongraphTraceResult = SessiongraphSessionTraceResult | SessiongraphEventTraceResult;
 /** Every request the seam accepts, discriminated on `operation`. */
-export type SessiongraphRequest = SessiongraphSearchRequest | SessiongraphSessionRequest | SessiongraphTimelineRequest | SessiongraphWorkspacesRequest | SessiongraphStatusRequest;
+export type SessiongraphRequest = SessiongraphSearchRequest | SessiongraphSessionRequest | SessiongraphEventRequest | SessiongraphTraceRequest | SessiongraphTimelineRequest | SessiongraphWorkspacesRequest | SessiongraphStatusRequest;
 /** The result type a given request produces. */
-export type SessiongraphResultFor<R extends SessiongraphRequest> = R extends SessiongraphSearchRequest ? SessiongraphSearchResult : R extends SessiongraphSessionRequest ? SessiongraphSessionResult : R extends SessiongraphTimelineRequest ? SessiongraphTimelineResult : R extends SessiongraphWorkspacesRequest ? SessiongraphWorkspacesResult : R extends SessiongraphStatusRequest ? SessiongraphStatusResult : never;
+export type SessiongraphResultFor<R extends SessiongraphRequest> = R extends SessiongraphSearchRequest ? SessiongraphSearchResult : R extends SessiongraphSessionRequest ? SessiongraphSessionResult : R extends SessiongraphEventRequest ? SessiongraphEventResult : R extends SessiongraphTraceRequest ? SessiongraphTraceResult : R extends SessiongraphTimelineRequest ? SessiongraphTimelineResult : R extends SessiongraphWorkspacesRequest ? SessiongraphWorkspacesResult : R extends SessiongraphStatusRequest ? SessiongraphStatusResult : never;
 /** Every result the seam produces. */
-export type SessiongraphResult = SessiongraphSearchResult | SessiongraphSessionResult | SessiongraphTimelineResult | SessiongraphWorkspacesResult | SessiongraphStatusResult;
+export type SessiongraphResult = SessiongraphSearchResult | SessiongraphSessionResult | SessiongraphEventResult | SessiongraphTraceResult | SessiongraphTimelineResult | SessiongraphWorkspacesResult | SessiongraphStatusResult;
 /**
  * A read provider: answers queries from an index it claims.
  *

package/lib/types.js

@@ -8,8 +8,16 @@
  * never exposes a path to a table — only sessions, entries, and search hits.
  * @module dsh-plugin-sessiongraph-service/types
  */
-/** Every query operation the seam answers. */
-export const SESSIONGRAPH_OPERATIONS = ['search', 'session', 'timeline', 'workspaces', 'status'];
+/**
+ * Every query operation the seam answers.
+ *
+ * `event` and `trace` were added when the model-facing surface collapsed from two tools into one:
+ * the built-in session tools could read a single unabridged event and follow replacement/citation
+ * relationships, and a replacement that dropped those answers would be a downgrade rather than a
+ * swap. An index run is deliberately **not** here — it writes, so the tool routes it through
+ * `Sessiongraph.index()` instead of pretending a query provider can build an index.
+ */
+export const SESSIONGRAPH_OPERATIONS = ['search', 'session', 'event', 'trace', 'timeline', 'workspaces', 'status'];
 /**
  * What a searchable entry is, from the reader's point of view.
  *
@@ -18,6 +26,16 @@ export const SESSIONGRAPH_OPERATIONS = ['search', 'session', 'timeline', 'worksp
  * 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.1.21",
+  "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",