@noetaris/harness 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -687,6 +687,36 @@ declare class StoreLoadError extends Error {
     readonly cause: unknown;
     constructor(cause: unknown);
 }
+/**
+ * Thrown by {@link Agent.run} when `store.claim()` returns `null` —
+ * another instance already holds the session claim.
+ *
+ * The caller may inspect `retryAfter` to implement a `429 Retry-After`
+ * response or a retry backoff. How to respond is not the framework's concern.
+ */
+declare class SessionBusyError extends Error {
+    /** The session that is currently claimed by another instance. */
+    readonly sessionId: string;
+    /**
+     * Hint: earliest time (milliseconds since epoch) when a retry may succeed.
+     * Derived from the original claim's `expiresAt`. Present when the store
+     * includes expiry information in a busy response; absent otherwise.
+     */
+    readonly retryAfter?: number;
+    constructor(sessionId: string, retryAfter?: number);
+}
+/**
+ * Thrown by the framework at a step boundary when the active lease has expired
+ * without renewal.
+ *
+ * The run stops without saving state — the session remains at its last
+ * checkpoint, allowing another instance to claim and resume it.
+ */
+declare class LeaseExpiredError extends Error {
+    /** The session whose lease expired. */
+    readonly sessionId: string;
+    constructor(sessionId: string);
+}
 
 /**
  * Identifies the agent and session for run-level observer callbacks.
@@ -804,4 +834,4 @@ interface ObserverAware {
  */
 declare function composeObservers(...observers: Observer[]): Observer;
 
-export { type Agent, type ClaimOptions, type DeepWithMarkers, type FieldDefinition, type FrameworkState, type Harness, type Lease, type LoopDefinition, LoopNotDefinedError, NoInterruptError, type Observer, type ObserverAware, REQUIRED_TAG, RUNTIME_TAG, type RequiredMarker, type RouteFn, type RunContext, type RunFn, type RuntimeMarker, SessionInFlightError, SessionPendingInterruptError, type SessionStore, type SignalTransition, type StateFromSchema, type StepContext, type StepDef, type StepState, StoreLoadError, type StoredRun, type StoredRunMetadata, type TransitionTarget, composeObservers, createAgent, createHarness, field, isRequiredMarker, isRuntimeMarker, required, runtime };
+export { type Agent, type ClaimOptions, type DeepWithMarkers, type FieldDefinition, type FrameworkState, type Harness, type Lease, LeaseExpiredError, type LoopDefinition, LoopNotDefinedError, NoInterruptError, type Observer, type ObserverAware, REQUIRED_TAG, RUNTIME_TAG, type RequiredMarker, type RouteFn, type RunContext, type RunFn, type RuntimeMarker, SessionBusyError, SessionInFlightError, SessionPendingInterruptError, type SessionStore, type SignalTransition, type StateFromSchema, type StepContext, type StepDef, type StepState, StoreLoadError, type StoredRun, type StoredRunMetadata, type TransitionTarget, composeObservers, createAgent, createHarness, field, isRequiredMarker, isRuntimeMarker, required, runtime };

package/dist/index.js

@@ -1508,10 +1508,12 @@ function composeObservers(...observers) {
   };
 }
 export {
+  LeaseExpiredError,
   LoopNotDefinedError,
   NoInterruptError,
   REQUIRED_TAG,
   RUNTIME_TAG,
+  SessionBusyError,
   SessionInFlightError,
   SessionPendingInterruptError,
   StoreLoadError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetaris/harness",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Agent execution framework — harness implementation",
   "type": "module",
   "repository": {