@harness-nexus/cli 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/daemon/dsh-sessions.d.ts

@@ -0,0 +1,161 @@
+import type { ChatStreamEvent, HistoryItem } from '@harness-nexus/shared';
+export type FrameDecoder = (frame: Buffer) => Buffer;
+/** The native `zlib.zstdDecompressSync`, or null on Node < 22.15. */
+export declare function nativeZstd(): FrameDecoder | null;
+/** Slice a concatenated-zstd buffer into its frames (magic scan). */
+export declare function splitZstdFrames(buf: Buffer): Buffer[];
+/**
+ * Decode every frame and parse the JSONL entries. Undecodable frames (a magic
+ * hit inside compressed data — ~2^-32 per position) and non-JSON lines are
+ * skipped, never fatal. Entries are capped so a runaway transcript can't
+ * exhaust memory.
+ */
+export declare function decodeTranscript(buf: Buffer, decompress: FrameDecoder, maxEntries?: number): Record<string, unknown>[];
+export interface DshSessionSummary {
+    sessionId: string;
+    cwd: string;
+    title: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    /** The model route the session pinned (`request/header.config.model`). */
+    model: string | null;
+}
+interface DshHeader {
+    createdAt?: unknown;
+    cwd?: unknown;
+    delegationDepth?: unknown;
+    parentSession?: unknown;
+}
+/**
+ * Header + derived title + pinned model from the FRONT of a transcript
+ * (dsh's own `session/list` exposes none of these). Stops as soon as all are
+ * found; bounded read so a huge transcript costs at most `maxBytes`. NB: the
+ * `session` HEADER entry carries its fields at the TOP level (no `data`
+ * wrapper), unlike every other entry type.
+ */
+export declare function scanSummary(buf: Buffer, decompress: FrameDecoder, maxBytes?: number): {
+    header: DshHeader | null;
+    title: string | null;
+    model: string | null;
+    hasTurn: boolean;
+};
+/**
+ * The model ids of OUR managed provider region in `~/.dsh/settings.yaml`
+ * (the W3 writer's own format — a `models:` list of `- id:` entries). Null
+ * when the region is absent/unparseable: the caller then annotates nothing.
+ */
+export declare function currentCatalogModels(settingsYaml: string): Set<string> | null;
+export interface DshListFs {
+    readdir: (path: string) => string[];
+    readFile: (path: string) => Buffer;
+    stat: (path: string) => {
+        mtimeMs: number;
+    };
+}
+/**
+ * List dsh's ROOT sessions (subagent sessions carry `parentSession`/depth and
+ * are dsh's own resume-exclusions). Pure given the fs shims; newest first.
+ */
+export declare function dshListSessions(sessionsDir: string, fs: DshListFs, decompress: FrameDecoder, opts?: {
+    maxSessions?: number;
+}): DshSessionSummary[];
+type UnknownRecord = Record<string, unknown>;
+/** The usage marker of a verbatim `assistant/chunk` row (history path). */
+export declare function usageFromChunk(entry: UnknownRecord): ChatStreamEvent | null;
+/**
+ * The stateful LIVE mapper: one dsh transcript entry → 0..n stream events.
+ * Mirrors the semantics of dsh's own in-process bridge mapper (reference:
+ * `updates.js` `createEventMapper`, engine/storage shapes verified against
+ * dsh 0.1.2-rc.1 — the exact rig version):
+ *
+ * - Deltas arrive in TWO on-disk shapes: packed `text-chunks`/
+ *   `reasoning-chunks` rows (runs of ≥3 seq-contiguous same-block deltas) and
+ *   verbatim `assistant/chunk` events (shorter runs — the codec's MIN_RUN=3
+ *   falls through). Both map; skipping either would silently drop content.
+ * - Committed `assistant/message` carries the step's dedup key: if deltas for
+ *   that `turn:step` were already emitted, ONLY the usage rides through
+ *   (re-sending the full block would double-render); if none were (late tail
+ *   attach, block-only adapters), the complete blocks are emitted — the wire's
+ *   committed chunk is suppressed while the tail is live, so this fallback is
+ *   the only copy. Tool-call blocks are skipped: the `tool/call` row owns them.
+ * - Turn markers and user inputs never map live — the prompt response owns
+ *   turn_result, and the browser echoes the user's own prompt.
+ */
+export type DshLiveMapper = (entry: UnknownRecord) => ChatStreamEvent[];
+export declare function createDshLiveMapper(): DshLiveMapper;
+/**
+ * Map dsh transcript entries onto history items (user blocks + ordinary
+ * stream events — ONE fold path in the browser). Genuine user turns are the
+ * `agent/inbox/spliced` inserts; `user/message` echoes and the synthesized
+ * runtime-context messages are skipped.
+ */
+export declare function dshHistoryItems(entries: UnknownRecord[]): HistoryItem[];
+/** Locate a session's transcript by id across the slug dirs (null = absent). */
+export declare function findTranscript(sessionsDir: string, sessionId: string, readdir: (path: string) => string[]): string | null;
+/** The fs surface `TranscriptTail` needs (injectable for tests). */
+export interface TailFs {
+    /** Current byte size, or null while the file is absent. */
+    size(path: string): number | null;
+    /** The bytes from `start` to the current end (may grow mid-call — fine). */
+    readEnd(path: string, start: number): Buffer;
+}
+/** Runtime knobs for `TranscriptTail`. */
+export interface TailOptions {
+    /** Poll interval (default 250ms — dsh flushes write batches ~100–300ms apart). */
+    intervalMs?: number;
+    /**
+     * Fired when the file corrupts mid-stream (a bounded frame that fails to
+     * decode): the tail stops itself and the caller should fall back to the
+     * adapter's committed chunks (wire suppression must lift).
+     */
+    onFatal?: (reason: string) => void;
+}
+/**
+ * Tails a dsh transcript for LIVE token streaming. Ground truth (dsh
+ * 0.1.2-rc.1 write path): every engine `assistant/chunk` event rides the
+ * session bus into a bounded write-behind batch (~100–300ms window) and lands
+ * as one zstd frame per batch — so polling the file yields token batches
+ * roughly one write window behind the model, while dsh's ACP adapter stays
+ * silent until commit. New bytes are split into frames, decoded, and mapped
+ * through a stateful `createDshLiveMapper` (packed rows AND verbatim chunk
+ * events, with the `turn:step` committed-dedup — see its doc).
+ *
+ * A trailing frame cut mid-write decodes only once its remaining bytes
+ * arrive: the last undecodable slice is buffered for the next poll (the
+ * writer completes it on the next batch or truncates it back on rollback).
+ * `start()` skips existing bytes (history was already rendered);
+ * `flush()` drains once more so a turn's final tokens stay ordered before
+ * its turn_result. A BOUNDED frame that fails to decode is corruption —
+ * `onFatal` fires and the tail stops (the committed path takes over).
+ */
+export declare class TranscriptTail {
+    private readonly file;
+    private readonly fs;
+    private readonly decompress;
+    private readonly onEvent;
+    private readonly opts;
+    private pending;
+    private timer;
+    private stopped;
+    private offset;
+    private readonly mapper;
+    /** Wall-clock of the last `turn/end` row seen (0 = none). */
+    private lastTurnEndAt;
+    constructor(file: string, fs: TailFs, decompress: FrameDecoder, onEvent: (event: ChatStreamEvent) => void, opts?: TailOptions);
+    /** Begin polling. `replayFromBeginning` re-maps the whole file instead of
+     * skipping existing bytes — valid ONLY when nothing in it was ever
+     * rendered (a lazily-materialized new-session transcript attached mid-turn:
+     * replaying recovers the deltas that landed before the attach; the
+     * caller guarantees no earlier turn ran through the committed path). */
+    start(replayFromBeginning?: boolean): void;
+    /** Whether a `turn/end` row landed since `since` (the settle signal). */
+    turnEndSeenSince(since: number): boolean;
+    /** One synchronous drain (call before settling a turn). */
+    flush(): void;
+    stop(): void;
+    private poll;
+    private drain;
+    private emitLines;
+}
+export {};
+//# sourceMappingURL=dsh-sessions.d.ts.map

package/dist/daemon/dsh-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-sessions.d.ts","sourceRoot":"","sources":["../../src/daemon/dsh-sessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA6B1E,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAErD,qEAAqE;AACrE,wBAAgB,UAAU,IAAI,YAAY,GAAG,IAAI,CAGhD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,YAAY,EACxB,UAAU,SAAQ,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuB3B;AAID,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,YAAY,EACxB,QAAQ,SAAY,GACnB;IAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyC5F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAQ7E;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,YAAY,EACxB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,iBAAiB,EAAE,CAiErB;AAID,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyF7C,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAM3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,eAAe,EAAE,CAAC;AAExE,wBAAgB,mBAAmB,IAAI,aAAa,CAkFnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,CA6EvE;AAgBD,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAClC,MAAM,GAAG,IAAI,CAiBf;AAED,oEAAoE;AACpE,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,4EAA4E;IAC5E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbvB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,6DAA6D;IAC7D,OAAO,CAAC,aAAa,CAAK;gBAGP,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EACzC,IAAI,GAAE,WAAgB;IAGzC;;;;4EAIwE;IACxE,KAAK,CAAC,mBAAmB,UAAQ,GAAG,IAAI;IAMxC,yEAAyE;IACzE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxC,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAOZ,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,KAAK;IAwBb,OAAO,CAAC,SAAS;CAclB"}