omk-agent-core 0.98.0 → 0.98.2

package/dist/harness/subscriber-fanout.js

@@ -0,0 +1,73 @@
+/**
+ * Subscriber fan-out with a self-wait barrier, extracted from `AgentHarness`.
+ *
+ * A listener that awaits the end of the very operation whose emission it is
+ * blocking forms a cycle. The call that closes that cycle (`waitForIdle()`,
+ * `abort()`) is always made during the listener's *synchronous* prologue — an
+ * async function body runs synchronously up to its first `await` — so marking
+ * just that window identifies callback-originated waits exactly, without
+ * falsely rejecting an unrelated concurrent caller that runs later while the
+ * listener's promise is merely pending.
+ *
+ * This module imports no harness or session types so it stays a leaf for the
+ * import-cycle ratchet; the harness passes the current operation id in.
+ */
+import { AgentHarnessError } from "./errors.js";
+import { normalizeHarnessError } from "./operation-outcome.js";
+export class SubscriberFanout {
+    listeners = new Set();
+    /** Non-zero only while a subscriber's synchronous prologue is on the stack. */
+    syncFrameDepth = 0;
+    operationId;
+    eventType;
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Deliver `event` to every subscriber in order; a throwing subscriber fails the emission as `hook`. */
+    async emit(event, currentOperationId, signal) {
+        for (const listener of this.listeners) {
+            const previousOperationId = this.operationId;
+            const previousEventType = this.eventType;
+            this.operationId = currentOperationId;
+            this.eventType = event.type;
+            let pending;
+            this.syncFrameDepth += 1;
+            try {
+                pending = listener(event, signal);
+            }
+            catch (error) {
+                this.operationId = previousOperationId;
+                this.eventType = previousEventType;
+                throw normalizeHarnessError(error, "hook");
+            }
+            finally {
+                this.syncFrameDepth -= 1;
+            }
+            try {
+                await pending;
+            }
+            catch (error) {
+                throw normalizeHarnessError(error, "hook");
+            }
+            finally {
+                this.operationId = previousOperationId;
+                this.eventType = previousEventType;
+            }
+        }
+    }
+    /**
+     * Fail closed when an awaited listener tries to wait on its own operation.
+     * Rejecting immediately turns a permanent deadlock into a classified error.
+     *
+     * Scope: this catches a wait issued from the listener's synchronous prologue,
+     * which covers `await harness.waitForIdle()` / `await harness.abort()`. A wait
+     * deferred behind an unrelated `await` inside the listener is not detected.
+     */
+    assertNotSelfWait(api, currentOperationId) {
+        if (this.syncFrameDepth > 0 && currentOperationId !== undefined && currentOperationId === this.operationId) {
+            throw new AgentHarnessError("invalid_state", `${api} cannot await the current operation from an awaited ${this.eventType ?? "unknown"} callback`);
+        }
+    }
+}
+//# sourceMappingURL=subscriber-fanout.js.map

package/dist/harness/subscriber-fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-fanout.js","sourceRoot":"","sources":["../../src/harness/subscriber-fanout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,MAAM,OAAO,gBAAgB;IACX,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IACnE,+EAA+E;IACvE,cAAc,GAAG,CAAC,CAAC;IACnB,WAAW,CAAqB;IAChC,SAAS,CAAqB;IAEtC,SAAS,CAAC,QAAoC,EAAc;QAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAAA,CAC7C;IAED,wGAAwG;IACxG,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,kBAAsC,EAAE,MAAoB,EAAiB;QACtG,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,CAAC;YAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC;YACtC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YAC5B,IAAI,OAAmC,CAAC;YACxC,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC;gBACJ,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,mBAAmB,CAAC;gBACvC,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC;gBACnC,MAAM,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;oBAAS,CAAC;gBACV,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,OAAO,CAAC;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;oBAAS,CAAC;gBACV,IAAI,CAAC,WAAW,GAAG,mBAAmB,CAAC;gBACvC,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC;YACpC,CAAC;QACF,CAAC;IAAA,CACD;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,GAAW,EAAE,kBAAsC,EAAQ;QAC5E,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5G,MAAM,IAAI,iBAAiB,CAC1B,eAAe,EACf,GAAG,GAAG,uDAAuD,IAAI,CAAC,SAAS,IAAI,SAAS,WAAW,CACnG,CAAC;QACH,CAAC;IAAA,CACD;CACD","sourcesContent":["/**\n * Subscriber fan-out with a self-wait barrier, extracted from `AgentHarness`.\n *\n * A listener that awaits the end of the very operation whose emission it is\n * blocking forms a cycle. The call that closes that cycle (`waitForIdle()`,\n * `abort()`) is always made during the listener's *synchronous* prologue — an\n * async function body runs synchronously up to its first `await` — so marking\n * just that window identifies callback-originated waits exactly, without\n * falsely rejecting an unrelated concurrent caller that runs later while the\n * listener's promise is merely pending.\n *\n * This module imports no harness or session types so it stays a leaf for the\n * import-cycle ratchet; the harness passes the current operation id in.\n */\n\nimport { AgentHarnessError } from \"./errors.ts\";\nimport { normalizeHarnessError } from \"./operation-outcome.ts\";\n\nexport type SubscriberListener<TEvent> = (event: TEvent, signal?: AbortSignal) => Promise<void> | void;\n\nexport class SubscriberFanout<TEvent extends { readonly type: string }> {\n\tprivate readonly listeners = new Set<SubscriberListener<TEvent>>();\n\t/** Non-zero only while a subscriber's synchronous prologue is on the stack. */\n\tprivate syncFrameDepth = 0;\n\tprivate operationId: string | undefined;\n\tprivate eventType: string | undefined;\n\n\tsubscribe(listener: SubscriberListener<TEvent>): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/** Deliver `event` to every subscriber in order; a throwing subscriber fails the emission as `hook`. */\n\tasync emit(event: TEvent, currentOperationId: string | undefined, signal?: AbortSignal): Promise<void> {\n\t\tfor (const listener of this.listeners) {\n\t\t\tconst previousOperationId = this.operationId;\n\t\t\tconst previousEventType = this.eventType;\n\t\t\tthis.operationId = currentOperationId;\n\t\t\tthis.eventType = event.type;\n\t\t\tlet pending: Promise<unknown> | unknown;\n\t\t\tthis.syncFrameDepth += 1;\n\t\t\ttry {\n\t\t\t\tpending = listener(event, signal);\n\t\t\t} catch (error) {\n\t\t\t\tthis.operationId = previousOperationId;\n\t\t\t\tthis.eventType = previousEventType;\n\t\t\t\tthrow normalizeHarnessError(error, \"hook\");\n\t\t\t} finally {\n\t\t\t\tthis.syncFrameDepth -= 1;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait pending;\n\t\t\t} catch (error) {\n\t\t\t\tthrow normalizeHarnessError(error, \"hook\");\n\t\t\t} finally {\n\t\t\t\tthis.operationId = previousOperationId;\n\t\t\t\tthis.eventType = previousEventType;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Fail closed when an awaited listener tries to wait on its own operation.\n\t * Rejecting immediately turns a permanent deadlock into a classified error.\n\t *\n\t * Scope: this catches a wait issued from the listener's synchronous prologue,\n\t * which covers `await harness.waitForIdle()` / `await harness.abort()`. A wait\n\t * deferred behind an unrelated `await` inside the listener is not detected.\n\t */\n\tassertNotSelfWait(api: string, currentOperationId: string | undefined): void {\n\t\tif (this.syncFrameDepth > 0 && currentOperationId !== undefined && currentOperationId === this.operationId) {\n\t\t\tthrow new AgentHarnessError(\n\t\t\t\t\"invalid_state\",\n\t\t\t\t`${api} cannot await the current operation from an awaited ${this.eventType ?? \"unknown\"} callback`,\n\t\t\t);\n\t\t}\n\t}\n}\n"]}

package/dist/harness/summarization-retry.d.ts

@@ -0,0 +1,29 @@
+import type { RetryCallbacks, RetryPolicy } from "omk-ai";
+export type SummarizationOperation = "compaction" | "branch_summary";
+export interface RetryScheduledEvent {
+    readonly type: "retry_scheduled";
+    readonly operation: SummarizationOperation;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly delayMs: number;
+    readonly errorMessage: string;
+}
+export interface RetryAttemptStartEvent {
+    readonly type: "retry_attempt_start";
+    readonly operation: SummarizationOperation;
+    readonly attempt: number;
+}
+export interface RetryFinishedEvent {
+    readonly type: "retry_finished";
+    readonly operation: SummarizationOperation;
+    readonly success: boolean;
+    readonly attempt: number;
+    readonly finalError?: string;
+}
+export type SummarizationRetryEvent = RetryScheduledEvent | RetryAttemptStartEvent | RetryFinishedEvent;
+/** Build retry policy/callbacks without coupling the leaf module to harness event types. */
+export declare function createSummarizationRetry(operation: SummarizationOperation, policy: RetryPolicy | undefined, emit: (event: SummarizationRetryEvent) => Promise<void> | void): {
+    readonly retry: RetryPolicy | undefined;
+    readonly callbacks: RetryCallbacks;
+};
+//# sourceMappingURL=summarization-retry.d.ts.map

package/dist/harness/summarization-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization-retry.d.ts","sourceRoot":"","sources":["../../src/harness/summarization-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAErE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;AAExG,4FAA4F;AAC5F,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,sBAAsB,EACjC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC5D;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CAAE,CAiBjF","sourcesContent":["import type { RetryCallbacks, RetryPolicy } from \"omk-ai\";\n\nexport type SummarizationOperation = \"compaction\" | \"branch_summary\";\n\nexport interface RetryScheduledEvent {\n\treadonly type: \"retry_scheduled\";\n\treadonly operation: SummarizationOperation;\n\treadonly attempt: number;\n\treadonly maxAttempts: number;\n\treadonly delayMs: number;\n\treadonly errorMessage: string;\n}\n\nexport interface RetryAttemptStartEvent {\n\treadonly type: \"retry_attempt_start\";\n\treadonly operation: SummarizationOperation;\n\treadonly attempt: number;\n}\n\nexport interface RetryFinishedEvent {\n\treadonly type: \"retry_finished\";\n\treadonly operation: SummarizationOperation;\n\treadonly success: boolean;\n\treadonly attempt: number;\n\treadonly finalError?: string;\n}\n\nexport type SummarizationRetryEvent = RetryScheduledEvent | RetryAttemptStartEvent | RetryFinishedEvent;\n\n/** Build retry policy/callbacks without coupling the leaf module to harness event types. */\nexport function createSummarizationRetry(\n\toperation: SummarizationOperation,\n\tpolicy: RetryPolicy | undefined,\n\temit: (event: SummarizationRetryEvent) => Promise<void> | void,\n): { readonly retry: RetryPolicy | undefined; readonly callbacks: RetryCallbacks } {\n\tlet scheduledAttempt = 0;\n\treturn {\n\t\tretry: policy,\n\t\tcallbacks: {\n\t\t\tonRetryScheduled: async (attempt, maxAttempts, delayMs, errorMessage) => {\n\t\t\t\tscheduledAttempt = attempt;\n\t\t\t\tawait emit({ type: \"retry_scheduled\", operation, attempt, maxAttempts, delayMs, errorMessage });\n\t\t\t},\n\t\t\tonRetryAttemptStart: async () => {\n\t\t\t\tawait emit({ type: \"retry_attempt_start\", operation, attempt: scheduledAttempt });\n\t\t\t},\n\t\t\tonRetryFinished: async (success, attempt, finalError) => {\n\t\t\t\tawait emit({ type: \"retry_finished\", operation, success, attempt, finalError });\n\t\t\t},\n\t\t},\n\t};\n}\n"]}

package/dist/harness/summarization-retry.js

@@ -0,0 +1,20 @@
+/** Build retry policy/callbacks without coupling the leaf module to harness event types. */
+export function createSummarizationRetry(operation, policy, emit) {
+    let scheduledAttempt = 0;
+    return {
+        retry: policy,
+        callbacks: {
+            onRetryScheduled: async (attempt, maxAttempts, delayMs, errorMessage) => {
+                scheduledAttempt = attempt;
+                await emit({ type: "retry_scheduled", operation, attempt, maxAttempts, delayMs, errorMessage });
+            },
+            onRetryAttemptStart: async () => {
+                await emit({ type: "retry_attempt_start", operation, attempt: scheduledAttempt });
+            },
+            onRetryFinished: async (success, attempt, finalError) => {
+                await emit({ type: "retry_finished", operation, success, attempt, finalError });
+            },
+        },
+    };
+}
+//# sourceMappingURL=summarization-retry.js.map

package/dist/harness/summarization-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization-retry.js","sourceRoot":"","sources":["../../src/harness/summarization-retry.ts"],"names":[],"mappings":"AA6BA,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CACvC,SAAiC,EACjC,MAA+B,EAC/B,IAA8D,EACoB;IAClF,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,OAAO;QACN,KAAK,EAAE,MAAM;QACb,SAAS,EAAE;YACV,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC;gBACxE,gBAAgB,GAAG,OAAO,CAAC;gBAC3B,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAAA,CAChG;YACD,mBAAmB,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAAA,CAClF;YACD,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC;gBACxD,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAAA,CAChF;SACD;KACD,CAAC;AAAA,CACF","sourcesContent":["import type { RetryCallbacks, RetryPolicy } from \"omk-ai\";\n\nexport type SummarizationOperation = \"compaction\" | \"branch_summary\";\n\nexport interface RetryScheduledEvent {\n\treadonly type: \"retry_scheduled\";\n\treadonly operation: SummarizationOperation;\n\treadonly attempt: number;\n\treadonly maxAttempts: number;\n\treadonly delayMs: number;\n\treadonly errorMessage: string;\n}\n\nexport interface RetryAttemptStartEvent {\n\treadonly type: \"retry_attempt_start\";\n\treadonly operation: SummarizationOperation;\n\treadonly attempt: number;\n}\n\nexport interface RetryFinishedEvent {\n\treadonly type: \"retry_finished\";\n\treadonly operation: SummarizationOperation;\n\treadonly success: boolean;\n\treadonly attempt: number;\n\treadonly finalError?: string;\n}\n\nexport type SummarizationRetryEvent = RetryScheduledEvent | RetryAttemptStartEvent | RetryFinishedEvent;\n\n/** Build retry policy/callbacks without coupling the leaf module to harness event types. */\nexport function createSummarizationRetry(\n\toperation: SummarizationOperation,\n\tpolicy: RetryPolicy | undefined,\n\temit: (event: SummarizationRetryEvent) => Promise<void> | void,\n): { readonly retry: RetryPolicy | undefined; readonly callbacks: RetryCallbacks } {\n\tlet scheduledAttempt = 0;\n\treturn {\n\t\tretry: policy,\n\t\tcallbacks: {\n\t\t\tonRetryScheduled: async (attempt, maxAttempts, delayMs, errorMessage) => {\n\t\t\t\tscheduledAttempt = attempt;\n\t\t\t\tawait emit({ type: \"retry_scheduled\", operation, attempt, maxAttempts, delayMs, errorMessage });\n\t\t\t},\n\t\t\tonRetryAttemptStart: async () => {\n\t\t\t\tawait emit({ type: \"retry_attempt_start\", operation, attempt: scheduledAttempt });\n\t\t\t},\n\t\t\tonRetryFinished: async (success, attempt, finalError) => {\n\t\t\t\tawait emit({ type: \"retry_finished\", operation, success, attempt, finalError });\n\t\t\t},\n\t\t},\n\t};\n}\n"]}

package/dist/harness/tree-navigation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tree-navigation helpers extracted from `AgentHarness.navigateTree`.
+ *
+ * These cover the two self-contained steps of a navigation — deciding where to
+ * land, and producing a branch summary — so the harness method is left with
+ * lifecycle staging, hook dispatch, and the session commit.
+ */
+import type { Model, RetryPolicy } from "omk-ai";
+import { type SummarizationRetryEvent } from "./summarization-retry.ts";
+import type { SessionTreeEntry } from "./types.ts";
+export interface NavigationTarget {
+    /** Leaf the session should move to. */
+    readonly newLeafId: string | null;
+    /** Original text of a user-authored target, handed back for re-editing. */
+    readonly editorText?: string;
+}
+/**
+ * Where a navigation lands. Targeting a user-authored entry rewinds to its
+ * parent and returns that entry's text, so the caller can edit and resend it;
+ * any other entry is entered directly.
+ */
+export declare function resolveNavigationTarget(targetEntry: SessionTreeEntry, targetId: string): NavigationTarget;
+export type BranchSummaryOutcome = {
+    readonly cancelled: true;
+} | {
+    readonly cancelled: false;
+    readonly summary: string;
+    readonly details: unknown;
+};
+/**
+ * Summarize the entries being navigated away from. An aborted summary is a
+ * cancellation, not a failure; every other summarization error is classified
+ * as `branch_summary`.
+ */
+export declare function runBranchSummary(input: {
+    readonly entries: SessionTreeEntry[];
+    readonly model: Model<any>;
+    readonly apiKey: string;
+    readonly headers?: Record<string, string>;
+    readonly customInstructions?: string;
+    readonly replaceInstructions?: boolean;
+    readonly summarizationRetry: RetryPolicy | undefined;
+    readonly emit: (event: SummarizationRetryEvent) => Promise<void> | void;
+}): Promise<BranchSummaryOutcome>;
+//# sourceMappingURL=tree-navigation.d.ts.map

package/dist/harness/tree-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-navigation.d.ts","sourceRoot":"","sources":["../../src/harness/tree-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAgB,KAAK,EAAE,WAAW,EAAe,MAAM,QAAQ,CAAC;AAE5E,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWnD,MAAM,WAAW,gBAAgB;IAChC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAQzG;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmBhC","sourcesContent":["/**\n * Tree-navigation helpers extracted from `AgentHarness.navigateTree`.\n *\n * These cover the two self-contained steps of a navigation — deciding where to\n * land, and producing a branch summary — so the harness method is left with\n * lifecycle staging, hook dispatch, and the session commit.\n */\n\nimport type { ImageContent, Model, RetryPolicy, TextContent } from \"omk-ai\";\nimport { generateBranchSummary } from \"./compaction/branch-summarization.ts\";\nimport { createSummarizationRetry, type SummarizationRetryEvent } from \"./summarization-retry.ts\";\nimport type { SessionTreeEntry } from \"./types.ts\";\nimport { AgentHarnessError } from \"./types.ts\";\n\nfunction flattenText(content: string | (TextContent | ImageContent)[]): string {\n\tif (typeof content === \"string\") return content;\n\treturn content\n\t\t.filter((part): part is TextContent => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\nexport interface NavigationTarget {\n\t/** Leaf the session should move to. */\n\treadonly newLeafId: string | null;\n\t/** Original text of a user-authored target, handed back for re-editing. */\n\treadonly editorText?: string;\n}\n\n/**\n * Where a navigation lands. Targeting a user-authored entry rewinds to its\n * parent and returns that entry's text, so the caller can edit and resend it;\n * any other entry is entered directly.\n */\nexport function resolveNavigationTarget(targetEntry: SessionTreeEntry, targetId: string): NavigationTarget {\n\tif (targetEntry.type === \"message\" && targetEntry.message.role === \"user\") {\n\t\treturn { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.message.content) };\n\t}\n\tif (targetEntry.type === \"custom_message\") {\n\t\treturn { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.content) };\n\t}\n\treturn { newLeafId: targetId };\n}\n\nexport type BranchSummaryOutcome =\n\t| { readonly cancelled: true }\n\t| { readonly cancelled: false; readonly summary: string; readonly details: unknown };\n\n/**\n * Summarize the entries being navigated away from. An aborted summary is a\n * cancellation, not a failure; every other summarization error is classified\n * as `branch_summary`.\n */\nexport async function runBranchSummary(input: {\n\treadonly entries: SessionTreeEntry[];\n\treadonly model: Model<any>;\n\treadonly apiKey: string;\n\treadonly headers?: Record<string, string>;\n\treadonly customInstructions?: string;\n\treadonly replaceInstructions?: boolean;\n\treadonly summarizationRetry: RetryPolicy | undefined;\n\treadonly emit: (event: SummarizationRetryEvent) => Promise<void> | void;\n}): Promise<BranchSummaryOutcome> {\n\tconst result = await generateBranchSummary(input.entries, {\n\t\tmodel: input.model,\n\t\tapiKey: input.apiKey,\n\t\theaders: input.headers,\n\t\tsignal: new AbortController().signal,\n\t\tcustomInstructions: input.customInstructions,\n\t\treplaceInstructions: input.replaceInstructions,\n\t\t...createSummarizationRetry(\"branch_summary\", input.summarizationRetry, input.emit),\n\t});\n\tif (!result.ok) {\n\t\tif (result.error.code === \"aborted\") return { cancelled: true };\n\t\tthrow new AgentHarnessError(\"branch_summary\", result.error.message, result.error);\n\t}\n\treturn {\n\t\tcancelled: false,\n\t\tsummary: result.value.summary,\n\t\tdetails: { readFiles: result.value.readFiles, modifiedFiles: result.value.modifiedFiles },\n\t};\n}\n"]}

package/dist/harness/tree-navigation.js

@@ -0,0 +1,59 @@
+/**
+ * Tree-navigation helpers extracted from `AgentHarness.navigateTree`.
+ *
+ * These cover the two self-contained steps of a navigation — deciding where to
+ * land, and producing a branch summary — so the harness method is left with
+ * lifecycle staging, hook dispatch, and the session commit.
+ */
+import { generateBranchSummary } from "./compaction/branch-summarization.js";
+import { createSummarizationRetry } from "./summarization-retry.js";
+import { AgentHarnessError } from "./types.js";
+function flattenText(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
+/**
+ * Where a navigation lands. Targeting a user-authored entry rewinds to its
+ * parent and returns that entry's text, so the caller can edit and resend it;
+ * any other entry is entered directly.
+ */
+export function resolveNavigationTarget(targetEntry, targetId) {
+    if (targetEntry.type === "message" && targetEntry.message.role === "user") {
+        return { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.message.content) };
+    }
+    if (targetEntry.type === "custom_message") {
+        return { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.content) };
+    }
+    return { newLeafId: targetId };
+}
+/**
+ * Summarize the entries being navigated away from. An aborted summary is a
+ * cancellation, not a failure; every other summarization error is classified
+ * as `branch_summary`.
+ */
+export async function runBranchSummary(input) {
+    const result = await generateBranchSummary(input.entries, {
+        model: input.model,
+        apiKey: input.apiKey,
+        headers: input.headers,
+        signal: new AbortController().signal,
+        customInstructions: input.customInstructions,
+        replaceInstructions: input.replaceInstructions,
+        ...createSummarizationRetry("branch_summary", input.summarizationRetry, input.emit),
+    });
+    if (!result.ok) {
+        if (result.error.code === "aborted")
+            return { cancelled: true };
+        throw new AgentHarnessError("branch_summary", result.error.message, result.error);
+    }
+    return {
+        cancelled: false,
+        summary: result.value.summary,
+        details: { readFiles: result.value.readFiles, modifiedFiles: result.value.modifiedFiles },
+    };
+}
+//# sourceMappingURL=tree-navigation.js.map

package/dist/harness/tree-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-navigation.js","sourceRoot":"","sources":["../../src/harness/tree-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAgC,MAAM,0BAA0B,CAAC;AAElG,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,SAAS,WAAW,CAAC,OAAgD,EAAU;IAC9E,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AAAA,CACX;AASD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAA6B,EAAE,QAAgB,EAAoB;IAC1G,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC3C,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAAA,CAC/B;AAMD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAStC,EAAiC;IACjC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE;QACzD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;QACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC;KACnF,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QAChB,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACnF,CAAC;IACD,OAAO;QACN,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC7B,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;KACzF,CAAC;AAAA,CACF","sourcesContent":["/**\n * Tree-navigation helpers extracted from `AgentHarness.navigateTree`.\n *\n * These cover the two self-contained steps of a navigation — deciding where to\n * land, and producing a branch summary — so the harness method is left with\n * lifecycle staging, hook dispatch, and the session commit.\n */\n\nimport type { ImageContent, Model, RetryPolicy, TextContent } from \"omk-ai\";\nimport { generateBranchSummary } from \"./compaction/branch-summarization.ts\";\nimport { createSummarizationRetry, type SummarizationRetryEvent } from \"./summarization-retry.ts\";\nimport type { SessionTreeEntry } from \"./types.ts\";\nimport { AgentHarnessError } from \"./types.ts\";\n\nfunction flattenText(content: string | (TextContent | ImageContent)[]): string {\n\tif (typeof content === \"string\") return content;\n\treturn content\n\t\t.filter((part): part is TextContent => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\nexport interface NavigationTarget {\n\t/** Leaf the session should move to. */\n\treadonly newLeafId: string | null;\n\t/** Original text of a user-authored target, handed back for re-editing. */\n\treadonly editorText?: string;\n}\n\n/**\n * Where a navigation lands. Targeting a user-authored entry rewinds to its\n * parent and returns that entry's text, so the caller can edit and resend it;\n * any other entry is entered directly.\n */\nexport function resolveNavigationTarget(targetEntry: SessionTreeEntry, targetId: string): NavigationTarget {\n\tif (targetEntry.type === \"message\" && targetEntry.message.role === \"user\") {\n\t\treturn { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.message.content) };\n\t}\n\tif (targetEntry.type === \"custom_message\") {\n\t\treturn { newLeafId: targetEntry.parentId, editorText: flattenText(targetEntry.content) };\n\t}\n\treturn { newLeafId: targetId };\n}\n\nexport type BranchSummaryOutcome =\n\t| { readonly cancelled: true }\n\t| { readonly cancelled: false; readonly summary: string; readonly details: unknown };\n\n/**\n * Summarize the entries being navigated away from. An aborted summary is a\n * cancellation, not a failure; every other summarization error is classified\n * as `branch_summary`.\n */\nexport async function runBranchSummary(input: {\n\treadonly entries: SessionTreeEntry[];\n\treadonly model: Model<any>;\n\treadonly apiKey: string;\n\treadonly headers?: Record<string, string>;\n\treadonly customInstructions?: string;\n\treadonly replaceInstructions?: boolean;\n\treadonly summarizationRetry: RetryPolicy | undefined;\n\treadonly emit: (event: SummarizationRetryEvent) => Promise<void> | void;\n}): Promise<BranchSummaryOutcome> {\n\tconst result = await generateBranchSummary(input.entries, {\n\t\tmodel: input.model,\n\t\tapiKey: input.apiKey,\n\t\theaders: input.headers,\n\t\tsignal: new AbortController().signal,\n\t\tcustomInstructions: input.customInstructions,\n\t\treplaceInstructions: input.replaceInstructions,\n\t\t...createSummarizationRetry(\"branch_summary\", input.summarizationRetry, input.emit),\n\t});\n\tif (!result.ok) {\n\t\tif (result.error.code === \"aborted\") return { cancelled: true };\n\t\tthrow new AgentHarnessError(\"branch_summary\", result.error.message, result.error);\n\t}\n\treturn {\n\t\tcancelled: false,\n\t\tsummary: result.value.summary,\n\t\tdetails: { readFiles: result.value.readFiles, modifiedFiles: result.value.modifiedFiles },\n\t};\n}\n"]}

package/dist/harness/types.d.ts

@@ -1,6 +1,12 @@
-import type { ImageContent, Model, SimpleStreamOptions, TextContent, Transport } from "omk-ai";
-import type { AgentEvent, AgentMessage, AgentTool, QueueMode, ThinkingLevel } from "../index.ts";
+import type { ImageContent, Model, TextContent } from "omk-ai";
+import type { AgentEvent, AgentMessage, AgentTool, QueueMode, ThinkingLevel } from "../types.ts";
+export { AgentHarnessError, type AgentHarnessErrorCode, SessionError, type SessionErrorCode, toError, } from "./errors.ts";
+import type { HarnessAttemptRef, HarnessAttemptSummary, HarnessOperationOutcome, HarnessOperationRef } from "./operation-lifecycle-types.ts";
 import type { Session } from "./session/session.ts";
+import type { AgentHarnessStreamOptions, AgentHarnessStreamOptionsPatch } from "./stream-options.ts";
+import type { SummarizationRetryEvent } from "./summarization-retry.ts";
+export type { AgentHarnessStreamOptions, AgentHarnessStreamOptionsPatch } from "./stream-options.ts";
+export type { RetryAttemptStartEvent, RetryFinishedEvent, RetryScheduledEvent, SummarizationOperation, SummarizationRetryEvent, } from "./summarization-retry.ts";
 /** Result of a fallible operation. Expected failures are returned as `ok: false` instead of thrown. */
 export type Result<TValue, TError> = {
     ok: true;
@@ -17,8 +23,6 @@ export declare function err<TValue, TError>(error: TError): Result<TValue, TErro
 export declare function getOrThrow<TValue, TError>(result: Result<TValue, TError>): TValue;
 /** Return the success value or `undefined`. Only object values are allowed to avoid truthiness bugs with primitives. */
 export declare function getOrUndefined<TValue extends object, TError>(result: Result<TValue, TError>): TValue | undefined;
-/** Normalize unknown thrown values into Error instances before using them as typed error causes. */
-export declare function toError(error: unknown): Error;
 /**
  * Skill loaded from a `SKILL.md` file or provided by an application.
  *
@@ -53,30 +57,6 @@ export interface AgentHarnessResources<TSkill extends Skill = Skill, TPromptTemp
     /** Skills available to the model and explicit skill invocation. */
     skills?: TSkill[];
 }
-/** Curated provider request options owned by the harness and snapshotted per turn. */
-export interface AgentHarnessStreamOptions {
-    /** Preferred transport forwarded to the stream function. */
-    transport?: Transport;
-    /** Provider request timeout in milliseconds. */
-    timeoutMs?: number;
-    /** Maximum provider retry attempts. */
-    maxRetries?: number;
-    /** Optional cap for provider-requested retry delays. */
-    maxRetryDelayMs?: number;
-    /** Additional request headers merged with auth and lifecycle headers. */
-    headers?: Record<string, string>;
-    /** Provider metadata forwarded with requests. */
-    metadata?: SimpleStreamOptions["metadata"];
-    /** Provider cache retention hint. */
-    cacheRetention?: SimpleStreamOptions["cacheRetention"];
-}
-/** Per-request stream option patch returned by provider hooks. */
-export interface AgentHarnessStreamOptionsPatch extends Omit<Partial<AgentHarnessStreamOptions>, "headers" | "metadata"> {
-    /** Header patch. `undefined` values delete keys; explicit `headers: undefined` clears all headers. */
-    headers?: Record<string, string | undefined>;
-    /** Metadata patch. `undefined` values delete keys; explicit `metadata: undefined` clears all metadata. */
-    metadata?: Record<string, unknown | undefined>;
-}
 /** Kind of filesystem object as addressed by a {@link FileSystem}. Symlinks are not followed automatically. */
 export type FileKind = "file" | "directory" | "symlink";
 /** Stable, backend-independent file error codes returned by {@link FileSystem} file operations. */
@@ -113,19 +93,6 @@ export declare class BranchSummaryError extends Error {
     code: BranchSummaryErrorCode;
     constructor(code: BranchSummaryErrorCode, message: string, cause?: Error);
 }
-export type SessionErrorCode = "not_found" | "invalid_session" | "invalid_entry" | "invalid_fork_target" | "storage" | "unknown";
-/** Error thrown by session storage, repositories, and session tree operations. */
-export declare class SessionError extends Error {
-    /** Session subsystem error code. */
-    code: SessionErrorCode;
-    constructor(code: SessionErrorCode, message: string, cause?: Error);
-}
-export type AgentHarnessErrorCode = "busy" | "invalid_state" | "invalid_argument" | "session" | "hook" | "auth" | "compaction" | "branch_summary" | "unknown";
-/** Public AgentHarness failure with a stable top-level classification. */
-export declare class AgentHarnessError extends Error {
-    code: AgentHarnessErrorCode;
-    constructor(code: AgentHarnessErrorCode, message: string, cause?: Error);
-}
 /** Metadata for one filesystem object in a {@link FileSystem}. */
 export interface FileInfo {
     /** Basename of {@link path}. */
@@ -309,6 +276,12 @@ export interface JsonlSessionMetadata extends SessionMetadata {
     path: string;
     parentSessionPath?: string;
 }
+/**
+ * Durable session storage adapter.
+ *
+ * Mutation methods are non-reentrant: while a storage mutation is unsettled, its implementation must not call or await
+ * mutators on the owning `Session`, `HarnessSession`, or `AgentHarness`.
+ */
 export interface SessionStorage<TMetadata extends SessionMetadata = SessionMetadata> {
     getMetadata(): Promise<TMetadata>;
     getLeafId(): Promise<string | null>;
@@ -349,8 +322,37 @@ export interface JsonlSessionListOptions {
 }
 export interface JsonlSessionRepoApi extends SessionRepo<JsonlSessionMetadata, JsonlSessionCreateOptions, JsonlSessionListOptions> {
 }
+/**
+ * @deprecated Internal facade-gate vocabulary. Operation lifecycle state is
+ * owned by `OperationLifecycleController`; this union remains only as the
+ * session facade's write-gate mapping and will be removed at 1.0.
+ */
 export type AgentHarnessPhase = "idle" | "turn" | "compaction" | "branch_summary" | "retry";
 export type PendingSessionWrite = SessionTreeEntry extends infer TEntry ? TEntry extends SessionTreeEntry ? Omit<TEntry, "id" | "parentId" | "timestamp"> : never : never;
+export interface HarnessCustomMessageInput<T = unknown> {
+    readonly customType: string;
+    readonly content: string | readonly (TextContent | ImageContent)[];
+    readonly display: boolean;
+    readonly details?: T;
+}
+/** Public storage-free view over persisted session state and ordered extension writes. */
+export interface HarnessSession {
+    getMetadata(): Promise<Readonly<SessionMetadata>>;
+    getLeafId(): Promise<string | null>;
+    getEntry(id: string): Promise<Readonly<SessionTreeEntry> | undefined>;
+    getEntries(): Promise<readonly Readonly<SessionTreeEntry>[]>;
+    getBranch(fromId?: string): Promise<readonly Readonly<SessionTreeEntry>[]>;
+    buildContext(): Promise<Readonly<SessionContext>>;
+    getLabel(id: string): Promise<string | undefined>;
+    getSessionName(): Promise<string | undefined>;
+    getPendingWrites(): readonly PendingSessionWrite[];
+    appendMessage(message: AgentMessage): Promise<void>;
+    appendCustomEntry(customType: string, data?: unknown): Promise<void>;
+    appendCustomMessage<T = unknown>(input: HarnessCustomMessageInput<T>): Promise<void>;
+    appendLabel(targetId: string, label: string | undefined): Promise<void>;
+    appendSessionName(name: string): Promise<void>;
+    setLeafId(targetId: string | null): Promise<void>;
+}
 export interface QueueUpdateEvent {
     type: "queue_update";
     steer: AgentMessage[];
@@ -369,6 +371,23 @@ export interface AbortEvent {
 export interface SettledEvent {
     type: "settled";
     nextTurnCount: number;
+    /** Identity of the public operation that just settled exactly once. */
+    operationId: string;
+    outcome: HarnessOperationOutcome;
+    attemptCount: number;
+}
+export interface OperationStartedEvent {
+    type: "operation_started";
+    operation: HarnessOperationRef;
+}
+export interface AttemptStartedEvent {
+    type: "attempt_started";
+    attempt: HarnessAttemptRef;
+}
+/** Emitted once per low-level agent attempt; carries a bounded summary, never a transcript. */
+export interface AttemptFinishedEvent {
+    type: "attempt_finished";
+    summary: HarnessAttemptSummary;
 }
 export interface BeforeAgentStartEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> {
     type: "before_agent_start";
@@ -460,7 +479,7 @@ export interface ResourcesUpdateEvent<TSkill extends Skill = Skill, TPromptTempl
     resources: AgentHarnessResources<TSkill, TPromptTemplate>;
     previousResources: AgentHarnessResources<TSkill, TPromptTemplate>;
 }
-export type AgentHarnessOwnEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> = QueueUpdateEvent | SavePointEvent | AbortEvent | SettledEvent | BeforeAgentStartEvent<TSkill, TPromptTemplate> | ContextEvent | BeforeProviderRequestEvent | BeforeProviderPayloadEvent | AfterProviderResponseEvent | ToolCallEvent | ToolResultEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionBeforeTreeEvent | SessionTreeEvent | ModelUpdateEvent | ThinkingLevelUpdateEvent | ResourcesUpdateEvent<TSkill, TPromptTemplate> | ToolsUpdateEvent;
+export type AgentHarnessOwnEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> = QueueUpdateEvent | SavePointEvent | AbortEvent | SettledEvent | OperationStartedEvent | AttemptStartedEvent | AttemptFinishedEvent | BeforeAgentStartEvent<TSkill, TPromptTemplate> | ContextEvent | BeforeProviderRequestEvent | BeforeProviderPayloadEvent | AfterProviderResponseEvent | ToolCallEvent | ToolResultEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionBeforeTreeEvent | SessionTreeEvent | SummarizationRetryEvent | ModelUpdateEvent | ThinkingLevelUpdateEvent | ResourcesUpdateEvent<TSkill, TPromptTemplate> | ToolsUpdateEvent;
 export type AgentHarnessEvent<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> = AgentEvent | AgentHarnessOwnEvent<TSkill, TPromptTemplate>;
 export interface BeforeAgentStartResult {
     messages?: AgentMessage[];
@@ -511,6 +530,9 @@ export type AgentHarnessEventResultMap = {
     session_compact: undefined;
     session_before_tree: SessionBeforeTreeResult | undefined;
     session_tree: undefined;
+    retry_scheduled: undefined;
+    retry_attempt_start: undefined;
+    retry_finished: undefined;
     model_update: undefined;
     thinking_level_update: undefined;
     resources_update: undefined;
@@ -519,6 +541,9 @@ export type AgentHarnessEventResultMap = {
     save_point: undefined;
     abort: undefined;
     settled: undefined;
+    operation_started: undefined;
+    attempt_started: undefined;
+    attempt_finished: undefined;
 };
 export interface AgentHarnessPromptOptions {
     images?: ImageContent[];
@@ -606,11 +631,12 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
     } | undefined>;
     /** Curated stream/provider request options. Snapshotted at turn start. */
     streamOptions?: AgentHarnessStreamOptions;
+    /** Automatic compaction thresholds. Defaults to {@link DEFAULT_COMPACTION_SETTINGS}. */
+    compaction?: CompactionSettings;
     model: Model<any>;
     thinkingLevel?: ThinkingLevel;
     activeToolNames?: string[];
     steeringMode?: QueueMode;
     followUpMode?: QueueMode;
 }
-export type { AgentHarness } from "./agent-harness.ts";
 //# sourceMappingURL=types.d.ts.map