@oneharness/sdk 0.18.0 → 0.19.0

package/dist/generated/capabilities.d.ts

@@ -958,6 +958,11 @@ export declare const CAPABILITIES: {
             readonly flag: "--variant";
             readonly kind: "value";
             readonly unless: null;
+        }, {
+            readonly option: "session";
+            readonly flag: "--session";
+            readonly kind: "value";
+            readonly unless: null;
         }, {
             readonly option: "project";
             readonly flag: "--project";

package/dist/generated/capabilities.js

@@ -1084,6 +1084,12 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "session",
+                flag: "--session",
+                kind: "value",
+                unless: null,
+            },
             {
                 option: "project",
                 flag: "--project",

package/dist/generated/contracts.d.ts

@@ -566,8 +566,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -577,9 +579,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/history-line.d.ts

@@ -7,6 +7,14 @@ export type HistoryLine = ({
     harness_id?: string | null | undefined;
     run_id: string;
     schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
+    /**
+     * The name of the session this line belongs to — the `name` its run's
+     * closing `run` line will carry — so a run still in progress (events but
+     * no closing line yet) can be listed and followed by name. Omitted when
+     * absent: lines written before it existed carry none, and every reader
+     * that predates it ignores it.
+     */
+    session_name?: string | null | undefined;
     type: "event";
     variant?: string | null | undefined;
     [k: string]: unknown;
@@ -19,6 +27,14 @@ export type HistoryLine = ({
     harness_id?: string | null | undefined;
     run_id: string;
     schema_version: "1.0" | "1.1";
+    /**
+     * The name of the session this line belongs to — the `name` its run's
+     * closing `run` line will carry — so a run still in progress (events but
+     * no closing line yet) can be listed and followed by name. Omitted when
+     * absent: lines written before it existed carry none, and every reader
+     * that predates it ignores it.
+     */
+    session_name?: string | null | undefined;
     type: "event";
     variant?: string | null | undefined;
     [k: string]: unknown;
@@ -412,8 +428,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -423,9 +441,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/history-list.d.ts

@@ -1,8 +1,12 @@
 export type HistoryList = HistorySessionSummary[];
 /**
- * A one-line summary of a session, for `oneharness history list`. Read from the
- * session's records: `name`/`project`/`started` come from the first record,
- * `harnesses` is the distinct set across all records.
+ * A one-line summary of a session, for `oneharness history list`, read from
+ * both its closing `run` records and its event lines. `name`/`project`/
+ * `started` come from the first record; a session still in its first turn has
+ * none yet, so they fall back to the events' `session_name`, the project
+ * directory's slug, and the instant in the session id. `harnesses` is the
+ * distinct set across records and events, and `running` says an event's run
+ * has no closing record yet.
  */
 export interface HistorySessionSummary {
     /**
@@ -30,6 +34,12 @@ export interface HistorySessionSummary {
      * How many harness-run records the session holds.
      */
     record_count: number;
+    /**
+     * Whether a harness run in this session has written events but not yet
+     * its closing record — the run is still going (or ended without one: a
+     * killed process leaves the same file). Omitted when false.
+     */
+    running?: boolean | undefined;
     /**
      * The RFC3339 UTC start time (first record's timestamp); empty if unknown.
      */

package/dist/generated/history-records.d.ts

@@ -49,6 +49,9 @@ export type HistoryRecord = {
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     }))[] | null;
     exit_code: number | null;
     /**
@@ -207,6 +210,9 @@ export type HistoryRecord = {
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     })) & {
         timing_source?: never | undefined;
         [k: string]: unknown;
@@ -1363,8 +1369,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -1374,9 +1382,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/history-stream-envelope.d.ts

@@ -126,6 +126,9 @@ export type HistoryRecord = {
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     }))[] | null;
     exit_code: number | null;
     /**
@@ -284,6 +287,9 @@ export type HistoryRecord = {
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     })) & {
         timing_source?: never | undefined;
         [k: string]: unknown;
@@ -1375,6 +1381,14 @@ export type HistoryEventLine = {
     harness_id?: string | null | undefined;
     run_id: string;
     schema_version: "1.2" | "1.3" | "1.4" | "1.5" | "1.6" | "1.7" | "1.8" | "1.9";
+    /**
+     * The name of the session this line belongs to — the `name` its run's
+     * closing `run` line will carry — so a run still in progress (events but
+     * no closing line yet) can be listed and followed by name. Omitted when
+     * absent: lines written before it existed carry none, and every reader
+     * that predates it ignores it.
+     */
+    session_name?: string | null | undefined;
     variant?: string | null | undefined;
     [k: string]: unknown;
 } | {
@@ -1386,6 +1400,14 @@ export type HistoryEventLine = {
     harness_id?: string | null | undefined;
     run_id: string;
     schema_version: "1.0" | "1.1";
+    /**
+     * The name of the session this line belongs to — the `name` its run's
+     * closing `run` line will carry — so a run still in progress (events but
+     * no closing line yet) can be listed and followed by name. Omitted when
+     * absent: lines written before it existed carry none, and every reader
+     * that predates it ignores it.
+     */
+    session_name?: string | null | undefined;
     variant?: string | null | undefined;
     [k: string]: unknown;
 };
@@ -1401,8 +1423,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -1412,9 +1436,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/history-watch-options.d.ts

@@ -22,6 +22,12 @@ export interface HistoryWatchOptions {
      */
     noConfig?: boolean | undefined;
     project?: string | undefined;
+    /**
+     * Follow one session: its id, or its name (the newest session so named
+     * whose labels match every label filter, including one still running, or
+     * the first to appear).
+     */
+    session?: string | null | undefined;
     /**
      * Narrow to one configured harness identity (`claude-code:work`).
      */

package/dist/generated/history.d.ts

@@ -112,6 +112,9 @@ export type HistoryRecord = ({
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     }))[] | null;
     exit_code: number | null;
     /**
@@ -270,6 +273,9 @@ export type HistoryRecord = ({
     }) | (ActionEvent & {
         kind?: "tool_result" | undefined;
         [k: string]: unknown;
+    }) | (ActionEvent & {
+        kind?: "message" | "reasoning" | undefined;
+        [k: string]: unknown;
     })) & {
         timing_source?: never | undefined;
         [k: string]: unknown;
@@ -1367,8 +1373,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -1378,9 +1386,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/run-stream-envelope.d.ts

@@ -169,8 +169,10 @@ export interface ActionEvent {
     duration_ms: number | null;
     finished_at: string | null;
     /**
-     * Position of this event within the run, so "≤ N tool calls" and "did X
-     * before Y" are expressible from a stable ordering (also array order).
+     * Position of this event within the run, so "did X before Y" is
+     * expressible from a stable ordering (also array order). It counts every
+     * kind, so tool calls interleaved with `message`/`reasoning` events do not
+     * carry contiguous indexes; count tool calls by `kind`, not by `index`.
      */
     index: number;
     /**
@@ -180,9 +182,13 @@ export interface ActionEvent {
      */
     input: unknown;
     /**
-     * The kind of event: `tool_call` (the model invoked a tool) or
-     * `tool_result` (the observation returned to the model). Left open for
-     * future kinds rather than an enum, so a new shape never breaks the field.
+     * The kind of event: `tool_call` (the model invoked a tool),
+     * `tool_result` (the observation returned to the model), `message` (the
+     * agent's own text, in `output`) or `reasoning` (its reasoning text, in
+     * `output`). A `message` or `reasoning` event is one finished item, never
+     * a token delta. Left open for future kinds rather than an enum, so a new
+     * shape never breaks the field — a consumer counting tool calls filters on
+     * it (see [`ActionEvent::is_tool_activity`]).
      */
     kind: string;
     /**

package/dist/generated/schemas.json

@@ -1153,6 +1153,12 @@
                     "kind": "value",
                     "unless": null
                 },
+                {
+                    "option": "session",
+                    "flag": "--session",
+                    "kind": "value",
+                    "unless": null
+                },
                 {
                     "option": "project",
                     "flag": "--project",
@@ -1508,7 +1514,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -1517,7 +1523,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -2589,7 +2595,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -2598,7 +2604,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -4257,6 +4263,18 @@
             "project": {
                 "type": "string"
             },
+            "session": {
+                "description": "Follow one session: its id, or its name (the newest session so named\nwhose labels match every label filter, including one still running, or\nthe first to appear).",
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "minLength": 1,
+                "not": {
+                    "pattern": "[^A-Za-z0-9-]|^-|-$|--"
+                },
+                "pattern": "^(?:[a-z0-9-]+|[a-z0-9-]+-(?:[0-9]{4}(?:(?:0[13578]|1[02])(?:0[1-9]|[12][0-9]|3[01])|(?:0[469]|11)(?:0[1-9]|[12][0-9]|30)|02(?:0[1-9]|1[0-9]|2[0-8]))|(?:[0-9]{2}(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00)0229)T(?:[01][0-9]|2[0-3])[0-5][0-9][0-5][0-9]Z-[0-9]+)$"
+            },
             "variant": {
                 "description": "Narrow to one configured harness identity (`claude-code:work`).",
                 "type": "string"
@@ -4331,6 +4349,17 @@
                                                     "1.9"
                                                 ]
                                             },
+                                            "session_name": {
+                                                "description": "The name of the session this line belongs to — the `name` its run's\nclosing `run` line will carry — so a run still in progress (events but\nno closing line yet) can be listed and followed by name. Omitted when\nabsent: lines written before it existed carry none, and every reader\nthat predates it ignores it.",
+                                                "type": [
+                                                    "string",
+                                                    "null"
+                                                ],
+                                                "minLength": 1,
+                                                "not": {
+                                                    "pattern": "[^a-z0-9-]|^-|-$|--"
+                                                }
+                                            },
                                             "type": {
                                                 "type": "string",
                                                 "const": "event"
@@ -4393,6 +4422,17 @@
                                                     "1.1"
                                                 ]
                                             },
+                                            "session_name": {
+                                                "description": "The name of the session this line belongs to — the `name` its run's\nclosing `run` line will carry — so a run still in progress (events but\nno closing line yet) can be listed and followed by name. Omitted when\nabsent: lines written before it existed carry none, and every reader\nthat predates it ignores it.",
+                                                "type": [
+                                                    "string",
+                                                    "null"
+                                                ],
+                                                "minLength": 1,
+                                                "not": {
+                                                    "pattern": "[^a-z0-9-]|^-|-$|--"
+                                                }
+                                            },
                                             "type": {
                                                 "type": "string",
                                                 "const": "event"
@@ -5940,7 +5980,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -5949,7 +5989,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -6788,6 +6828,25 @@
                                             }
                                         }
                                     ]
+                                },
+                                {
+                                    "allOf": [
+                                        {
+                                            "$ref": "#/$defs/ActionEvent"
+                                        },
+                                        {
+                                            "type": "object",
+                                            "properties": {
+                                                "kind": {
+                                                    "type": "string",
+                                                    "enum": [
+                                                        "message",
+                                                        "reasoning"
+                                                    ]
+                                                }
+                                            }
+                                        }
+                                    ]
                                 }
                             ]
                         }
@@ -7170,6 +7229,25 @@
                                                     }
                                                 }
                                             ]
+                                        },
+                                        {
+                                            "allOf": [
+                                                {
+                                                    "$ref": "#/$defs/ActionEvent"
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "kind": {
+                                                            "type": "string",
+                                                            "enum": [
+                                                                "message",
+                                                                "reasoning"
+                                                            ]
+                                                        }
+                                                    }
+                                                }
+                                            ]
                                         }
                                     ]
                                 },
@@ -8942,7 +9020,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -8951,7 +9029,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -9326,7 +9404,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -9335,7 +9413,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -9496,6 +9574,17 @@
                                             "1.9"
                                         ]
                                     },
+                                    "session_name": {
+                                        "description": "The name of the session this line belongs to — the `name` its run's\nclosing `run` line will carry — so a run still in progress (events but\nno closing line yet) can be listed and followed by name. Omitted when\nabsent: lines written before it existed carry none, and every reader\nthat predates it ignores it.",
+                                        "type": [
+                                            "string",
+                                            "null"
+                                        ],
+                                        "minLength": 1,
+                                        "not": {
+                                            "pattern": "[^a-z0-9-]|^-|-$|--"
+                                        }
+                                    },
                                     "variant": {
                                         "type": [
                                             "string",
@@ -9553,6 +9642,17 @@
                                             "1.1"
                                         ]
                                     },
+                                    "session_name": {
+                                        "description": "The name of the session this line belongs to — the `name` its run's\nclosing `run` line will carry — so a run still in progress (events but\nno closing line yet) can be listed and followed by name. Omitted when\nabsent: lines written before it existed carry none, and every reader\nthat predates it ignores it.",
+                                        "type": [
+                                            "string",
+                                            "null"
+                                        ],
+                                        "minLength": 1,
+                                        "not": {
+                                            "pattern": "[^a-z0-9-]|^-|-$|--"
+                                        }
+                                    },
                                     "variant": {
                                         "type": [
                                             "string",
@@ -10113,6 +10213,25 @@
                                                     }
                                                 }
                                             ]
+                                        },
+                                        {
+                                            "allOf": [
+                                                {
+                                                    "$ref": "#/$defs/ActionEvent"
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "kind": {
+                                                            "type": "string",
+                                                            "enum": [
+                                                                "message",
+                                                                "reasoning"
+                                                            ]
+                                                        }
+                                                    }
+                                                }
+                                            ]
                                         }
                                     ]
                                 }
@@ -10495,6 +10614,25 @@
                                                             }
                                                         }
                                                     ]
+                                                },
+                                                {
+                                                    "allOf": [
+                                                        {
+                                                            "$ref": "#/$defs/ActionEvent"
+                                                        },
+                                                        {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "kind": {
+                                                                    "type": "string",
+                                                                    "enum": [
+                                                                        "message",
+                                                                        "reasoning"
+                                                                    ]
+                                                                }
+                                                            }
+                                                        }
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -12448,7 +12586,7 @@
                         ]
                     },
                     "index": {
-                        "description": "Position of this event within the run, so \"≤ N tool calls\" and \"did X\nbefore Y\" are expressible from a stable ordering (also array order).",
+                        "description": "Position of this event within the run, so \"did X before Y\" is\nexpressible from a stable ordering (also array order). It counts every\nkind, so tool calls interleaved with `message`/`reasoning` events do not\ncarry contiguous indexes; count tool calls by `kind`, not by `index`.",
                         "type": "integer",
                         "format": "uint",
                         "minimum": 0
@@ -12457,7 +12595,7 @@
                         "description": "Structured, tool-shaped arguments (the command string, the file path),\nso a consumer asserts on specific args without re-parsing; `null` when the\nevent carries none (e.g. a `tool_result`)."
                     },
                     "kind": {
-                        "description": "The kind of event: `tool_call` (the model invoked a tool) or\n`tool_result` (the observation returned to the model). Left open for\nfuture kinds rather than an enum, so a new shape never breaks the field.",
+                        "description": "The kind of event: `tool_call` (the model invoked a tool),\n`tool_result` (the observation returned to the model), `message` (the\nagent's own text, in `output`) or `reasoning` (its reasoning text, in\n`output`). A `message` or `reasoning` event is one finished item, never\na token delta. Left open for future kinds rather than an enum, so a new\nshape never breaks the field — a consumer counting tool calls filters on\nit (see [`ActionEvent::is_tool_activity`]).",
                         "type": "string"
                     },
                     "name": {
@@ -13121,6 +13259,25 @@
                                                     }
                                                 }
                                             ]
+                                        },
+                                        {
+                                            "allOf": [
+                                                {
+                                                    "$ref": "#/$defs/ActionEvent"
+                                                },
+                                                {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "kind": {
+                                                            "type": "string",
+                                                            "enum": [
+                                                                "message",
+                                                                "reasoning"
+                                                            ]
+                                                        }
+                                                    }
+                                                }
+                                            ]
                                         }
                                     ]
                                 }
@@ -13503,6 +13660,25 @@
                                                             }
                                                         }
                                                     ]
+                                                },
+                                                {
+                                                    "allOf": [
+                                                        {
+                                                            "$ref": "#/$defs/ActionEvent"
+                                                        },
+                                                        {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "kind": {
+                                                                    "type": "string",
+                                                                    "enum": [
+                                                                        "message",
+                                                                        "reasoning"
+                                                                    ]
+                                                                }
+                                                            }
+                                                        }
+                                                    ]
                                                 }
                                             ]
                                         },
@@ -15456,7 +15632,7 @@
                 }
             },
             "HistorySessionSummary": {
-                "description": "A one-line summary of a session, for `oneharness history list`. Read from the\nsession's records: `name`/`project`/`started` come from the first record,\n`harnesses` is the distinct set across all records.",
+                "description": "A one-line summary of a session, for `oneharness history list`, read from\nboth its closing `run` records and its event lines. `name`/`project`/\n`started` come from the first record; a session still in its first turn has\nnone yet, so they fall back to the events' `session_name`, the project\ndirectory's slug, and the instant in the session id. `harnesses` is the\ndistinct set across records and events, and `running` says an event's run\nhas no closing record yet.",
                 "type": "object",
                 "properties": {
                     "harnesses": {
@@ -15492,6 +15668,10 @@
                         "format": "uint",
                         "minimum": 0
                     },
+                    "running": {
+                        "description": "Whether a harness run in this session has written events but not yet\nits closing record — the run is still going (or ended without one: a\nkilled process leaves the same file). Omitted when false.",
+                        "type": "boolean"
+                    },
                     "started": {
                         "description": "The RFC3339 UTC start time (first record's timestamp); empty if unknown.",
                         "type": "string"

package/dist/generated/zod.js

@@ -360,6 +360,17 @@ export const HistoryEventLineSchema = z.union([
             z.literal("1.9"),
         ])
             .refine((value) => value !== undefined, { message: "Required" }),
+        session_name: z
+            .union([
+            z
+                .string()
+                .min(1)
+                .refine((value) => !new RegExp("[^a-z0-9-]|^-|-$|--", "u").test(value), {
+                message: "Invalid string: must not contain [^a-z0-9-]|^-|-$|--",
+            }),
+            z.null(),
+        ])
+            .optional(),
         variant: z.union([z.string(), z.null()]).optional(),
     }),
     z.looseObject({
@@ -379,6 +390,17 @@ export const HistoryEventLineSchema = z.union([
         schema_version: z
             .union([z.literal("1.0"), z.literal("1.1")])
             .refine((value) => value !== undefined, { message: "Required" }),
+        session_name: z
+            .union([
+            z
+                .string()
+                .min(1)
+                .refine((value) => !new RegExp("[^a-z0-9-]|^-|-$|--", "u").test(value), {
+                message: "Invalid string: must not contain [^a-z0-9-]|^-|-$|--",
+            }),
+            z.null(),
+        ])
+            .optional(),
         variant: z.union([z.string(), z.null()]).optional(),
     }),
 ]);
@@ -419,6 +441,17 @@ export const HistoryLineSchema = z.union([
                 z.literal("1.9"),
             ])
                 .refine((value) => value !== undefined, { message: "Required" }),
+            session_name: z
+                .union([
+                z
+                    .string()
+                    .min(1)
+                    .refine((value) => !new RegExp("[^a-z0-9-]|^-|-$|--", "u").test(value), {
+                    message: "Invalid string: must not contain [^a-z0-9-]|^-|-$|--",
+                }),
+                z.null(),
+            ])
+                .optional(),
             type: z.literal("event").refine((value) => value !== undefined, { message: "Required" }),
             variant: z.union([z.string(), z.null()]).optional(),
         }),
@@ -439,6 +472,17 @@ export const HistoryLineSchema = z.union([
             schema_version: z
                 .union([z.literal("1.0"), z.literal("1.1")])
                 .refine((value) => value !== undefined, { message: "Required" }),
+            session_name: z
+                .union([
+                z
+                    .string()
+                    .min(1)
+                    .refine((value) => !new RegExp("[^a-z0-9-]|^-|-$|--", "u").test(value), {
+                    message: "Invalid string: must not contain [^a-z0-9-]|^-|-$|--",
+                }),
+                z.null(),
+            ])
+                .optional(),
             type: z.literal("event").refine((value) => value !== undefined, { message: "Required" }),
             variant: z.union([z.string(), z.null()]).optional(),
         }),
@@ -1241,6 +1285,9 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
                 z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
                     kind: z.literal("tool_result").optional(),
                 })),
+                z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                    kind: z.union([z.literal("message"), z.literal("reasoning")]).optional(),
+                })),
             ])),
             z.null(),
         ])
@@ -1391,6 +1438,9 @@ export const HistoryRecordSchema = z.intersection(z.intersection(z.intersection(
                 z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
                     kind: z.literal("tool_result").optional(),
                 })),
+                z.intersection(z.lazy(() => ActionEventSchema), z.looseObject({
+                    kind: z.union([z.literal("message"), z.literal("reasoning")]).optional(),
+                })),
             ]), z.looseObject({
                 timing_source: z.never().optional(),
             }))),
@@ -2197,6 +2247,7 @@ export const HistorySessionSummarySchema = z.looseObject({
         .int()
         .gte(0)
         .refine((value) => value !== undefined, { message: "Required" }),
+    running: z.boolean().optional(),
     started: z.string().refine((value) => value !== undefined, { message: "Required" }),
 });
 export const HistoryStreamEnvelopeSchema = z.union([
@@ -2223,6 +2274,18 @@ export const HistoryWatchOptionsSchema = z.strictObject({
     labels: z.lazy(() => HistoryLabelsSchema).optional(),
     noConfig: z.boolean().optional(),
     project: z.string().optional(),
+    session: z
+        .union([
+        z
+            .string()
+            .min(1)
+            .regex(new RegExp("^(?:[a-z0-9-]+|[a-z0-9-]+-(?:[0-9]{4}(?:(?:0[13578]|1[02])(?:0[1-9]|[12][0-9]|3[01])|(?:0[469]|11)(?:0[1-9]|[12][0-9]|30)|02(?:0[1-9]|1[0-9]|2[0-8]))|(?:[0-9]{2}(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00)0229)T(?:[01][0-9]|2[0-3])[0-5][0-9][0-5][0-9]Z-[0-9]+)$", "u"))
+            .refine((value) => !new RegExp("[^A-Za-z0-9-]|^-|-$|--", "u").test(value), {
+            message: "Invalid string: must not contain [^A-Za-z0-9-]|^-|-$|--",
+        }),
+        z.null(),
+    ])
+        .optional(),
     variant: z.string().optional(),
 });
 export const HookEntrySchema = z.strictObject({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneharness/sdk",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Typed Node.js SDK for oneharness",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "oneharness-cli": "0.18.0",
+    "oneharness-cli": "0.19.0",
     "zod": "^4.4.3"
   }
 }