koneck 2.25.53 → 2.25.55

package/dist/trajectory.d.ts

@@ -0,0 +1,99 @@
+/**
+ * What happened, in order, with timings — the record a session needs to be inspectable.
+ *
+ * KONECK kept only the message list. That is enough to resume a conversation and useless for
+ * answering the questions people actually ask afterwards: where did twenty-five minutes go, which
+ * tool was slow, how long was it waiting for the first token rather than generating, what was it
+ * thinking before that edit. Every one of those was visible while it scrolled past and gone
+ * afterwards.
+ *
+ * The DeepSeek Harness records this properly and its trajectory view is the reason you can answer
+ * those questions there. This is the same idea at the scale a terminal can show: an append-only
+ * list of typed events with durations, written alongside the messages in the session file.
+ */
+export type TrajectoryEvent = 
+/** A turn began. */
+{
+    t: 'turn';
+    at: number;
+    turn: number;
+}
+/**
+ * One request to the model.
+ *
+ * `ttftMs` is time to first token — the wait before anything came back — kept apart from the
+ * total because they have completely different causes. A slow first token is the provider
+ * queueing or the prompt being large; slow generation after that is the model itself.
+ */
+ | {
+    t: 'request';
+    at: number;
+    ms: number;
+    ttftMs: number;
+    promptTokens: number;
+    completionTokens: number;
+}
+/** Reasoning arrived, and how much of it. */
+ | {
+    t: 'thinking';
+    at: number;
+    chars: number;
+}
+/** One tool call, with how long it took and whether it worked. */
+ | {
+    t: 'tool';
+    at: number;
+    name: string;
+    ms: number;
+    ok: boolean;
+    detail: string;
+    resultChars: number;
+}
+/** The conversation was summarised to fit. */
+ | {
+    t: 'compact';
+    at: number;
+    before: number;
+    after: number;
+}
+/** The run stopped for a stated reason rather than finishing. */
+ | {
+    t: 'stop';
+    at: number;
+    reason: string;
+};
+/** Bounded, because a long session should not be able to fill the disk with its own diary. */
+export declare const MAX_EVENTS = 5000;
+export declare class Trajectory {
+    private readonly events;
+    add(event: TrajectoryEvent): void;
+    all(): readonly TrajectoryEvent[];
+    get length(): number;
+}
+/** Totals worth knowing about a whole session, derived rather than tracked separately. */
+export interface TrajectorySummary {
+    turns: number;
+    requests: number;
+    modelMs: number;
+    toolMs: number;
+    waitingMs: number;
+    promptTokens: number;
+    completionTokens: number;
+    slowestTool?: {
+        name: string;
+        ms: number;
+    };
+    failedTools: number;
+    compactions: number;
+    thinkingChars: number;
+}
+export declare function summarise(events: readonly TrajectoryEvent[]): TrajectorySummary;
+/**
+ * The trajectory as a person reads it: where the time went, then the events themselves.
+ *
+ * The totals come first because they answer the question that prompted the look. "Twenty-five
+ * minutes, of which nineteen were waiting for first tokens" is the answer; the event list is the
+ * evidence for it.
+ */
+export declare function renderTrajectory(events: readonly TrajectoryEvent[], limit?: number): string;
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe;AACzB,oBAAoB;AAClB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACzC;;;;;;GAMG;GACD;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE;AAC1G,6CAA6C;GAC3C;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC9C,kEAAkE;GAChE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACvG,8CAA8C;GAC5C;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC7D,iEAAiE;GAC/D;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,8FAA8F;AAC9F,eAAO,MAAM,UAAU,OAAQ,CAAC;AAEhC,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOjC,GAAG,IAAI,SAAS,eAAe,EAAE;IAIjC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAOD,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,iBAAiB,CA4B/E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,KAAK,SAAK,GACT,MAAM,CAgDR"}

package/dist/trajectory.js

@@ -0,0 +1,125 @@
+/**
+ * What happened, in order, with timings — the record a session needs to be inspectable.
+ *
+ * KONECK kept only the message list. That is enough to resume a conversation and useless for
+ * answering the questions people actually ask afterwards: where did twenty-five minutes go, which
+ * tool was slow, how long was it waiting for the first token rather than generating, what was it
+ * thinking before that edit. Every one of those was visible while it scrolled past and gone
+ * afterwards.
+ *
+ * The DeepSeek Harness records this properly and its trajectory view is the reason you can answer
+ * those questions there. This is the same idea at the scale a terminal can show: an append-only
+ * list of typed events with durations, written alongside the messages in the session file.
+ */
+/** Bounded, because a long session should not be able to fill the disk with its own diary. */
+export const MAX_EVENTS = 5_000;
+export class Trajectory {
+    events = [];
+    add(event) {
+        // Dropping the oldest keeps the recent past, which is what anybody inspecting a session is
+        // asking about. Silently dropping the newest would be the wrong half.
+        if (this.events.length >= MAX_EVENTS)
+            this.events.shift();
+        this.events.push(event);
+    }
+    all() {
+        return this.events;
+    }
+    get length() {
+        return this.events.length;
+    }
+}
+const ms = (value) => value >= 10_000 ? `${(value / 1000).toFixed(0)}s`
+    : value >= 1_000 ? `${(value / 1000).toFixed(1)}s`
+        : `${Math.round(value)}ms`;
+export function summarise(events) {
+    const summary = {
+        turns: 0, requests: 0, modelMs: 0, toolMs: 0, waitingMs: 0,
+        promptTokens: 0, completionTokens: 0, failedTools: 0, compactions: 0, thinkingChars: 0,
+    };
+    for (const event of events) {
+        switch (event.t) {
+            case 'turn':
+                summary.turns++;
+                break;
+            case 'request':
+                summary.requests++;
+                summary.modelMs += event.ms;
+                summary.waitingMs += event.ttftMs;
+                summary.promptTokens += event.promptTokens;
+                summary.completionTokens += event.completionTokens;
+                break;
+            case 'tool':
+                summary.toolMs += event.ms;
+                if (!event.ok)
+                    summary.failedTools++;
+                if (!summary.slowestTool || event.ms > summary.slowestTool.ms) {
+                    summary.slowestTool = { name: event.name, ms: event.ms };
+                }
+                break;
+            case 'compact':
+                summary.compactions++;
+                break;
+            case 'thinking':
+                summary.thinkingChars += event.chars;
+                break;
+            default: break;
+        }
+    }
+    return summary;
+}
+/**
+ * The trajectory as a person reads it: where the time went, then the events themselves.
+ *
+ * The totals come first because they answer the question that prompted the look. "Twenty-five
+ * minutes, of which nineteen were waiting for first tokens" is the answer; the event list is the
+ * evidence for it.
+ */
+export function renderTrajectory(events, limit = 60) {
+    if (events.length === 0)
+        return 'Nothing recorded yet this session.';
+    const s = summarise(events);
+    const lines = [];
+    lines.push(`**${s.turns} turns**, ${s.requests} requests, ` +
+        `${(s.promptTokens + s.completionTokens).toLocaleString()} tokens`);
+    lines.push(`**Model** ${ms(s.modelMs)}   of which ${ms(s.waitingMs)} waiting for a first token`);
+    lines.push(`**Tools** ${ms(s.toolMs)}` +
+        (s.failedTools > 0 ? `   ${s.failedTools} failed` : '') +
+        (s.slowestTool ? `   slowest: ${s.slowestTool.name} ${ms(s.slowestTool.ms)}` : ''));
+    if (s.compactions > 0)
+        lines.push(`**Compacted** ${s.compactions} times`);
+    if (s.thinkingChars > 0) {
+        lines.push(`**Reasoning** about ${Math.round(s.thinkingChars / 4).toLocaleString()} tokens`);
+    }
+    lines.push('');
+    const shown = events.slice(-limit);
+    if (shown.length < events.length) {
+        lines.push(`*(the last ${shown.length} of ${events.length} events)*`);
+    }
+    for (const event of shown) {
+        switch (event.t) {
+            case 'turn':
+                lines.push(`**turn ${event.turn}**`);
+                break;
+            case 'request':
+                lines.push(`  model    ${ms(event.ms).padEnd(7)} first token ${ms(event.ttftMs).padEnd(7)}` +
+                    ` ${event.promptTokens.toLocaleString()} in / ${event.completionTokens.toLocaleString()} out`);
+                break;
+            case 'thinking':
+                lines.push(`  thinking ${Math.round(event.chars / 4).toLocaleString()} tokens`);
+                break;
+            case 'tool':
+                lines.push(`  ${event.ok ? 'tool' : 'FAIL'}     ${ms(event.ms).padEnd(7)} ${event.name}` +
+                    (event.detail ? `  ${event.detail.slice(0, 54)}` : ''));
+                break;
+            case 'compact':
+                lines.push(`  compact  ${event.before} messages to ${event.after}`);
+                break;
+            case 'stop':
+                lines.push(`  stopped  ${event.reason.slice(0, 88)}`);
+                break;
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koneck",
-  "version": "2.25.53",
+  "version": "2.25.55",
   "description": "Kinetically Orchestrated Neural Execution Engine for Code",
   "type": "module",
   "bin": {