@khorsheed/dsh-local-agent-kimi 0.2.0-rc.3 → 0.2.1

package/lib/types/session-view.d.ts

@@ -15,7 +15,13 @@
  * its transcript position so a delta mirror can sum a round's total.
  * @module @khorsheed/dsh-local-agent-kimi/session-view
  */
-import type { TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { ReasoningEffortId, TokenUsage } from '@deepseek-ai/dsh-llm';
+/** The request config one `llm.request` wire event declares (its own words). */
+export interface KimiRequestConfig {
+    model?: string;
+    reasoningEffort?: ReasoningEffortId;
+    maxTokens?: number;
+}
 /** One rendered transcript line. */
 export type KimiTranscriptLine = ({
     kind: 'user';
@@ -25,10 +31,14 @@ export type KimiTranscriptLine = ({
     kind: 'assistant';
     text: string;
     turn: number;
+    wireStep?: number;
+    requestConfig?: KimiRequestConfig;
 } | {
     kind: 'think';
     text: string;
     turn: number;
+    wireStep?: number;
+    requestConfig?: KimiRequestConfig;
 }
 /**
  * Tool activity: one call with its (possibly still pending) result. `id`
@@ -43,6 +53,8 @@ export type KimiTranscriptLine = ({
     args?: string;
     result?: string;
     turn: number;
+    wireStep?: number;
+    requestConfig?: KimiRequestConfig;
 }) & {
     model?: string;
 };
@@ -62,6 +74,13 @@ export interface KimiSessionTranscript {
         readonly line: number;
         readonly usage: TokenUsage;
     }[];
+    /**
+     * Wire steps (`${turn}:${wireStep}`, turn 1-based) whose `step.end` the wire
+     * recorded — a closed step's content is complete, so a mirror may fold it
+     * without waiting for the next step to begin. Older wires carry no step
+     * markers; their lines simply never appear here.
+     */
+    closedSteps: ReadonlySet<string>;
     /**
      * The model identifier the wire named: the `model` field of a `usage.record`
      * or `llm.request` event, LAST one seen (a resumed session's later rounds
@@ -89,7 +108,9 @@ export declare function readKimiTranscript(sessionDir: string): Promise<KimiSess
  * Map a wire `usage.record` payload onto the shared usage contract. kimi
  * reports input (uncached), cache read, cache creation, and output; the
  * creation counter is its cache-write analog. Non-numeric or missing
- * counters are dropped so the record stays usable when kimi omits a field.
+ * counters are dropped so the record stays usable when kimi omits a field;
+ * a reported cache-read counter is always written (zero included), so a
+ * reader can tell "no hits" from "not reported".
  * @param raw - the event's `usage` value.
  * @returns the shared usage record, or undefined when nothing was reported.
  */

package/lib/types/session-view.js

@@ -148,11 +148,20 @@ export async function readKimiTranscript(sessionDir) {
     const sessionId = sessionDir.split('session_').pop() ?? sessionDir;
     const lines = [];
     const usageRecords = [];
+    const closedSteps = new Set();
     let model;
     let modelTurn;
     let lineModel;
+    // The latest llm.request's declared config; content/tool lines carry a
+    // snapshot of it, so the mirror can write each folded step's request/header
+    // in the wire's own words.
+    let lineConfig;
     const push = (line) => {
-        lines.push({ ...line, ...lineModel === undefined ? {} : { model: lineModel } });
+        lines.push({
+            ...line,
+            ...lineModel === undefined ? {} : { model: lineModel },
+            ...line.kind !== 'user' && lineConfig !== undefined ? { requestConfig: { ...lineConfig } } : {},
+        });
     };
     // Wire turns are 0-based on loop events; a `turn.prompt` also opens a new
     // round. The transcript uses 1-based turns matching the dsh child session's
@@ -169,7 +178,7 @@ export async function readKimiTranscript(sessionDir) {
     }
     catch (error) {
         if (error.code === 'ENOENT') {
-            return { sessionId, lines, usageRecords };
+            return { sessionId, lines, usageRecords, closedSteps };
         }
         throw error;
     }
@@ -192,6 +201,11 @@ export async function readKimiTranscript(sessionDir) {
             if (typeof event.model === 'string' && event.model !== '') {
                 model = lineModel = event.model;
                 modelTurn = turn || 1;
+                // The record names the alias spelling (kimi-code/k3), llm.request the
+                // raw one (k3) — the pending header config follows the alias so the
+                // header and the message source name the model identically.
+                if (lineConfig !== undefined)
+                    lineConfig = { ...lineConfig, model: event.model };
             }
             const usage = usageFromWire(event.usage);
             if (usage !== undefined)
@@ -204,6 +218,13 @@ export async function readKimiTranscript(sessionDir) {
                 model = event.model;
                 modelTurn = turn || 1;
             }
+            // The header contract requires provider+model; a wire that names no
+            // model records no config at all rather than an invented one.
+            lineConfig = lineModel === undefined ? undefined : {
+                model: lineModel,
+                ...typeof event.thinkingEffort === 'string' && event.thinkingEffort !== '' ? { reasoningEffort: event.thinkingEffort } : {},
+                ...typeof event.maxTokens === 'number' && Number.isFinite(event.maxTokens) ? { maxTokens: event.maxTokens } : {},
+            };
             continue;
         }
         if (event.type === 'turn.prompt') {
@@ -252,13 +273,19 @@ export async function readKimiTranscript(sessionDir) {
                 turn = Math.max(turn, loopTurn);
                 turnSeen = true;
             }
+            // The wire's own 1-based step within the turn: one loop step is one LLM
+            // request (its think/text parts and tool calls share it), so the mirror
+            // folds per wire step. Older wires omit it — their lines fold singly.
+            const wireStep = typeof loop.step === 'number' ? loop.step : undefined;
             const part = loop.part;
             const lineTurn = turn === 0 ? 1 : turn;
+            if (loop.type === 'step.end' && wireStep !== undefined)
+                closedSteps.add(`${lineTurn}:${wireStep}`);
             if (part?.type === 'text' && part.text !== undefined && part.text.trim() !== '') {
-                push({ kind: 'assistant', text: part.text, turn: lineTurn });
+                push({ kind: 'assistant', text: part.text, turn: lineTurn, ...wireStep === undefined ? {} : { wireStep } });
             }
             else if (part?.type === 'think' && part.think !== undefined && part.think.trim() !== '') {
-                push({ kind: 'think', text: part.think, turn: lineTurn });
+                push({ kind: 'think', text: part.think, turn: lineTurn, ...wireStep === undefined ? {} : { wireStep } });
             }
             else if (loop.type === 'tool.call') {
                 const call = loop;
@@ -273,6 +300,7 @@ export async function readKimiTranscript(sessionDir) {
                     name,
                     ...args === undefined ? {} : { args },
                     turn: lineTurn,
+                    ...wireStep === undefined ? {} : { wireStep },
                 });
                 if (typeof call.uuid === 'string')
                     callsByUuid.set(call.uuid, lineIndex);
@@ -316,13 +344,15 @@ export async function readKimiTranscript(sessionDir) {
             }
         }
     }
-    return { sessionId, lines, usageRecords, ...model === undefined ? {} : { model }, ...modelTurn === undefined ? {} : { modelTurn } };
+    return { sessionId, lines, usageRecords, closedSteps, ...model === undefined ? {} : { model }, ...modelTurn === undefined ? {} : { modelTurn } };
 }
 /**
  * Map a wire `usage.record` payload onto the shared usage contract. kimi
  * reports input (uncached), cache read, cache creation, and output; the
  * creation counter is its cache-write analog. Non-numeric or missing
- * counters are dropped so the record stays usable when kimi omits a field.
+ * counters are dropped so the record stays usable when kimi omits a field;
+ * a reported cache-read counter is always written (zero included), so a
+ * reader can tell "no hits" from "not reported".
  * @param raw - the event's `usage` value.
  * @returns the shared usage record, or undefined when nothing was reported.
  */
@@ -345,7 +375,7 @@ export function usageFromWire(raw) {
         inputTokens: input ?? 0,
         outputTokens: output ?? 0,
     };
-    if (cacheRead !== undefined && cacheRead > 0)
+    if (cacheRead !== undefined)
         usage.cacheReadTokens = cacheRead;
     if (cacheWrite !== undefined && cacheWrite > 0)
         usage.cacheWriteTokens = cacheWrite;

package/package.json

@@ -8,7 +8,7 @@
     "local-agent",
     "kimi"
   ],
-  "version": "0.2.0-rc.3",
+  "version": "0.2.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -69,7 +69,7 @@
     "dsh": ">=0.1.5-rc.1 <0.3.0-0"
   },
   "dependencies": {
-    "@khorsheed/dsh-local-agent": "^0.2.0-rc.3"
+    "@khorsheed/dsh-local-agent": "^0.2.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",