vieval 0.0.10 → 0.0.12

package/dist/{index-Bg0atWBF.d.mts → index-CIaJClcC.d.mts}

@@ -1,42 +1,39 @@
 //#region src/core/scheduler/types.d.ts
 /**
- * Hierarchical scheduler scopes used by the queue runtime.
+ * Options accepted by {@link createSchedulerRuntime}.
  *
  * Use when:
- * - selecting which concurrency cap applies to a unit of work
- * - ordering middleware acquisition and release hooks
+ * - constructing a scheduler runtime with queue limits or middleware
  *
  * Expects:
- * - values move from broad to narrow scope in this order:
- *   `workspace -> project -> task -> attempt -> case`
+ * - omitted configuration falls back to unbounded execution for that concern
  *
  * Returns:
- * - a string literal scope identifier
+ * - queue and middleware configuration for the runtime
  */
-type SchedulerScope = 'workspace' | 'project' | 'task' | 'attempt' | 'case';
+interface CreateSchedulerRuntimeOptions {
+  concurrency?: SchedulerConcurrencyConfig;
+  middleware?: SchedulerMiddleware[];
+}
 /**
- * Context carried through queue acquisition, execution, and release.
+ * Per-scope concurrency limits used by the scheduler runtime.
  *
  * Use when:
- * - middleware needs stable identifiers for logging or instrumentation
- * - runtime helpers need to know which hierarchical scope is being executed
+ * - bounding parallel work for a specific scope
+ * - disabling a scope cap by omitting its entry
  *
  * Expects:
- * - `workspaceId` is always present
- * - `experimentId` is metadata for middleware and logging, not queue partitioning
- * - narrower ids are only provided when the selected scope requires them
+ * - values are positive integers when provided
  *
  * Returns:
- * - a serializable scope context object
+ * - a partial map of scheduler scope to concurrency cap
  */
-interface SchedulerScopeContext {
-  scope: SchedulerScope;
-  workspaceId: string;
-  experimentId: string;
-  projectName?: string;
-  taskId?: string;
-  attemptIndex?: number;
-  caseId?: string;
+interface SchedulerConcurrencyConfig {
+  attempt?: number;
+  case?: number;
+  project?: number;
+  task?: number;
+  workspace?: number;
 }
 /**
  * Middleware hooks wrapped around scheduler execution.
@@ -56,55 +53,58 @@ interface SchedulerMiddleware {
   onRelease?: (context: SchedulerScopeContext, next: () => Promise<void>) => Promise<void> | void;
 }
 /**
- * Per-scope concurrency limits used by the scheduler runtime.
+ * Runtime API used to execute case-level work through scheduler policies.
  *
  * Use when:
- * - bounding parallel work for a specific scope
- * - disabling a scope cap by omitting its entry
+ * - the runner needs to enqueue case execution under middleware and queue caps
  *
  * Expects:
- * - values are positive integers when provided
+ * - `runCase` receives a case context and a callback that performs the work
  *
  * Returns:
- * - a partial map of scheduler scope to concurrency cap
+ * - a promise that resolves with the callback result once all guards release
  */
-interface SchedulerConcurrencyConfig {
-  workspace?: number;
-  project?: number;
-  task?: number;
-  attempt?: number;
-  case?: number;
+interface SchedulerRuntime {
+  runCase: <T>(context: SchedulerScopeContext, execute: () => Promise<T>) => Promise<T>;
 }
 /**
- * Options accepted by {@link createSchedulerRuntime}.
+ * Hierarchical scheduler scopes used by the queue runtime.
  *
  * Use when:
- * - constructing a scheduler runtime with queue limits or middleware
+ * - selecting which concurrency cap applies to a unit of work
+ * - ordering middleware acquisition and release hooks
  *
  * Expects:
- * - omitted configuration falls back to unbounded execution for that concern
+ * - values move from broad to narrow scope in this order:
+ *   `workspace -> project -> task -> attempt -> case`
  *
  * Returns:
- * - queue and middleware configuration for the runtime
+ * - a string literal scope identifier
  */
-interface CreateSchedulerRuntimeOptions {
-  concurrency?: SchedulerConcurrencyConfig;
-  middleware?: SchedulerMiddleware[];
-}
+type SchedulerScope = 'attempt' | 'case' | 'project' | 'task' | 'workspace';
 /**
- * Runtime API used to execute case-level work through scheduler policies.
+ * Context carried through queue acquisition, execution, and release.
  *
  * Use when:
- * - the runner needs to enqueue case execution under middleware and queue caps
+ * - middleware needs stable identifiers for logging or instrumentation
+ * - runtime helpers need to know which hierarchical scope is being executed
  *
  * Expects:
- * - `runCase` receives a case context and a callback that performs the work
+ * - `workspaceId` is always present
+ * - `experimentId` is metadata for middleware and logging, not queue partitioning
+ * - narrower ids are only provided when the selected scope requires them
  *
  * Returns:
- * - a promise that resolves with the callback result once all guards release
+ * - a serializable scope context object
  */
-interface SchedulerRuntime {
-  runCase: <T>(context: SchedulerScopeContext, execute: () => Promise<T>) => Promise<T>;
+interface SchedulerScopeContext {
+  attemptIndex?: number;
+  caseId?: string;
+  experimentId: string;
+  projectName?: string;
+  scope: SchedulerScope;
+  taskId?: string;
+  workspaceId: string;
 }
 //#endregion
 //#region src/core/scheduler/runtime.d.ts
@@ -145,4 +145,4 @@ declare function createSchedulerRuntime(options?: CreateSchedulerRuntimeOptions)
 declare function getActiveScopes(context: SchedulerScopeContext): SchedulerScope[];
 //#endregion
 export { SchedulerMiddleware as a, SchedulerScopeContext as c, SchedulerConcurrencyConfig as i, getActiveScopes as n, SchedulerRuntime as o, CreateSchedulerRuntimeOptions as r, SchedulerScope as s, createSchedulerRuntime as t };
-//# sourceMappingURL=index-Bg0atWBF.d.mts.map
+//# sourceMappingURL=index-CIaJClcC.d.mts.map