@oneharness/sdk 0.17.1 → 0.19.0

package/dist/generated/capabilities.d.ts

@@ -202,7 +202,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -447,7 +447,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -581,7 +581,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -614,7 +614,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -662,7 +662,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -738,7 +738,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -879,7 +879,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -923,7 +923,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -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";
@@ -982,7 +987,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -1026,7 +1031,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {
@@ -1054,7 +1059,7 @@ export declare const CAPABILITIES: {
         }, {
             readonly option: "config";
             readonly flag: "--config";
-            readonly kind: "value";
+            readonly kind: "repeated";
             readonly unless: "noConfig";
             readonly unless_resolution: "refuse";
         }, {

package/dist/generated/capabilities.js

@@ -194,7 +194,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -488,7 +488,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -647,7 +647,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -685,7 +685,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -741,7 +741,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -829,7 +829,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -992,7 +992,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -1043,7 +1043,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -1084,6 +1084,12 @@ export const CAPABILITIES = {
                 kind: "value",
                 unless: null,
             },
+            {
+                option: "session",
+                flag: "--session",
+                kind: "value",
+                unless: null,
+            },
             {
                 option: "project",
                 flag: "--project",
@@ -1112,7 +1118,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -1163,7 +1169,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },
@@ -1195,7 +1201,7 @@ export const CAPABILITIES = {
             {
                 option: "config",
                 flag: "--config",
-                kind: "value",
+                kind: "repeated",
                 unless: "noConfig",
                 unless_resolution: "refuse",
             },

package/dist/generated/config-options.d.ts

@@ -2,7 +2,15 @@
  * Options accepted by the language SDKs' `config()`.
  */
 export interface ConfigOptions {
-    config?: string | undefined;
+    /**
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
+     */
+    config?: string[] | undefined;
     cwd?: string | undefined;
+    /**
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
+     */
     noConfig?: boolean | undefined;
 }

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/detect-options.d.ts

@@ -6,9 +6,17 @@ export interface DetectOptions {
     bins?: {
         [k: string]: string;
     } | undefined;
-    config?: string | undefined;
+    /**
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
+     */
+    config?: string[] | undefined;
     exclude?: string[] | undefined;
     harnesses?: string[] | undefined;
+    /**
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
+     */
     noConfig?: boolean | undefined;
     /**
      * Exit non-zero if any probed harness is not installed. The SDKs surface

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

@@ -3,8 +3,16 @@
  */
 export interface HistoryClearOptions {
     allProjects?: boolean | undefined;
-    config?: string | undefined;
+    /**
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
+     */
+    config?: string[] | undefined;
     historyDir?: string | undefined;
+    /**
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
+     */
     noConfig?: boolean | undefined;
     project?: string | undefined;
     /**

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-options.d.ts

@@ -4,13 +4,14 @@
 export interface HistoryListOptions {
     allProjects?: boolean | undefined;
     /**
-     * Load configuration from exactly this file, skipping user/project
-     * discovery.
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
      */
-    config?: string | undefined;
+    config?: string[] | undefined;
     historyDir?: string | undefined;
     /**
-     * Ignore every configuration file.
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
      */
     noConfig?: boolean | undefined;
     project?: string | undefined;

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-lookup.d.ts

@@ -34,10 +34,10 @@ export interface HistoryLookupByLast {
     all?: boolean | undefined;
     allProjects?: boolean | undefined;
     /**
-     * Load configuration from exactly this file, skipping user/project
-     * discovery.
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
      */
-    config?: string | undefined;
+    config?: string[] | undefined;
     historyDir?: string | undefined;
     /**
      * Select the most recent session. Only `true` selects, so this variant
@@ -45,7 +45,8 @@ export interface HistoryLookupByLast {
      */
     last: true;
     /**
-     * Ignore every configuration file.
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
      */
     noConfig?: boolean | undefined;
     project?: string | undefined;
@@ -67,10 +68,10 @@ export interface HistoryLookupBySession {
     all?: boolean | undefined;
     allProjects?: boolean | undefined;
     /**
-     * Load configuration from exactly this file, skipping user/project
-     * discovery.
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
      */
-    config?: string | undefined;
+    config?: string[] | undefined;
     historyDir?: string | undefined;
     /**
      * Whether the most recent session was asked for instead. An ordinary
@@ -80,7 +81,8 @@ export interface HistoryLookupBySession {
      */
     last?: boolean | undefined;
     /**
-     * Ignore every configuration file.
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
      */
     noConfig?: boolean | undefined;
     project?: string | undefined;

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

@@ -2,7 +2,15 @@
  * Options accepted by the language SDKs' `historyMigrate()`.
  */
 export interface HistoryMigrateOptions {
-    config?: string | undefined;
+    /**
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
+     */
+    config?: string[] | undefined;
     historyDir?: string | undefined;
+    /**
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
+     */
     noConfig?: boolean | undefined;
 }

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

@@ -9,18 +9,25 @@ export interface HistoryWatchOptions {
     after?: string | undefined;
     allProjects?: boolean | undefined;
     /**
-     * Load configuration from exactly this file, skipping user/project
-     * discovery.
+     * Load configuration from exactly these files, in order, skipping
+     * user/project discovery; each later file overrides the earlier ones.
      */
-    config?: string | undefined;
+    config?: string[] | undefined;
     events?: boolean | undefined;
     historyDir?: string | undefined;
     labels?: HistoryLabels | undefined;
     /**
-     * Ignore every configuration file.
+     * Ignore every configuration file and `ONEHARNESS_*` override. `true`
+     * beside a non-empty `config` is refused before anything runs.
      */
     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`).
      */