FE-1947: Add groundwork for the Wait flow action

[kostandinang]

🌟 Purpose

A Wait flow action will pause a run, then pass its input on unchanged. It will run as a child workflow that sleeps until the resume time, once flow actions can run as child workflows (FE-1935). This PR adds only the parts that don't depend on the engine.

🔍 Changes

Where	What it does
flows/wait.ts	resolveResumeAt works out when a Wait step resumes. checkWaitInputs checks its inputs when the flow is defined. Start here.
flows/types.ts, flow-definition-schema.ts	Adds the Duration ({ amount, unit }) and DateTime (ISO 8601 with Z or an offset) payload kinds.
run-flow-modal/types.ts	Marks both kinds as unsupported flow inputs.

How the resume time is worked out:

• Exactly one of duration and until must be set.
• An until time in the past resumes straight away.
• A wait over 30 days is an error, not shortened.

Decisions to review:

• parseDateTime uses a strict pattern instead of Date.parse, which reads a value without a timezone as local time.
• checkWaitInputs only checks constants. It skips the 30-day limit on until, because "now" isn't known when the flow is defined.
• Wait isn't an action definition yet, because it would then need an activity. The validator doesn't call checkWaitInputs yet.

⚠️ Known issues

• Nothing runs a Wait step yet. The action definition and the child workflow that runs it are FE-1954.
• The run flow modal can't take a Duration or DateTime input.

🛡 Tests

• wait.test.ts covers unit lengths, invalid and over-limit durations, until times (future, past, boundaries, malformed, offsets), neither or both inputs, each checkWaitInputs rule, and the schema accepting both constants.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Oct 13, 2026 3:45pm UTC

3 Skipped Deployments

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Oct 13, 2026 3:45pm UTC
petrinaut	Skipped		Oct 13, 2026 3:45pm UTC
petrinaut-docs	Skipped		Oct 13, 2026 3:45pm UTC

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (kostandin/fe-1926-if-filter-list@a5247a5). Learn more about missing BASE report.

Additional details and impacted files

@@                         Coverage Diff                         @@
##             kostandin/fe-1926-if-filter-list   #10021   +/-   ##
===================================================================
  Coverage                                    ?   68.07%           
===================================================================
  Files                                       ?     1962           
  Lines                                       ?   203325           
  Branches                                    ?     8555           
===================================================================
  Hits                                        ?   138410           
  Misses                                      ?    63262           
  Partials                                    ?     1653           

Flag	Coverage Δ
apps.hash-ai-worker-ts	4.39% <ø> (?)
apps.hash-api	15.32% <ø> (?)
local.hash-backend-utils	6.46% <ø> (?)
local.hash-isomorphic-utils	29.80% <100.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cursor]

PR Summary

Low Risk
Isolated shared utilities and types with no workflow execution path yet; behavior is covered by unit tests.

Overview
Adds engine-agnostic building blocks for a future Wait flow step: new Duration ({ amount, unit }) and DateTime (strict ISO 8601 with Z or offset) payload kinds, wired into flow types/schema JSON typing, and marked unsupported in the run-flow modal until UI exists.

New wait.ts implements resolveResumeAt (exactly one of duration or until; 30-day max; past until resumes immediately) with strict parseDateTime / duration parsing, plus checkWaitInputs for define-time validation of constant inputs. wait.test.ts covers parsing, limits, and schema acceptance. No Wait action definition or runtime/timer in this PR—follow-up work.

^{Reviewed by Cursor Bugbot for commit 440a77a. Bugbot is set up for automated code reviews on this repo. Configure here.}