@oniroproject/core 0.14.1 → 0.15.0

package/dist/index.d.cts

@@ -161,6 +161,12 @@ interface SdkRelease {
  */
 declare const ALL_SDKS: readonly SdkRelease[];
 declare const OHOS_URL_BASE = "https://repo.huaweicloud.com/openharmony/os";
+/**
+ * OpenHarmony daily builds. The full SDK (with `@systemapi` declarations) is not on the
+ * release mirror; its `ohos-sdk-full` archives are published here, to be installed with
+ * `installSdkFromArchive`.
+ */
+declare const OHOS_DAILY_BUILDS_URL = "https://dcp.openharmony.cn/workbench/cicd/dailybuild/dailylist";
 
 type OsFolder = 'linux' | 'darwin' | 'windows';
 /**
@@ -382,9 +388,15 @@ interface ExtractZipOptions {
  */
 declare function extractZipWithProgress(opts: ExtractZipOptions): Promise<void>;
 /**
- * Extract a tar/tar.gz/tar.bz2 archive. Wraps `tar.x`.
+ * Extract a tar/tar.gz/tar.bz2 archive. Wraps `tar.x`; `filter` receives each entry's
+ * archive path and skips the entry when it returns false.
  */
-declare function extractTarball(tarPath: string, dest: string, strip?: number): Promise<void>;
+declare function extractTarball(tarPath: string, dest: string, strip?: number, filter?: (entryPath: string) => boolean): Promise<void>;
+/**
+ * Contents of the first entry of a ZIP whose name `match` accepts, or undefined. Reads
+ * only the central directory and that entry, so it is cheap on multi-hundred-MB ZIPs.
+ */
+declare function readZipEntry(zipPath: string, match: (entryName: string) => boolean): Promise<Buffer | undefined>;
 
 interface SdkInfo {
     version: string;
@@ -434,6 +446,49 @@ interface InstallSdkOptions {
  *   95..100 Finalize + cleanup
  */
 declare function downloadAndInstallSdk(opts: InstallSdkOptions): Promise<void>;
+interface InstallSdkFromArchiveOptions {
+    config: ConfigProvider;
+    /**
+     * A local SDK tarball: an `ohos-sdk-full` archive from the daily builds
+     * (`OHOS_DAILY_BUILDS_URL`), or a public release downloaded by hand.
+     */
+    archivePath: string;
+    /** Replace an SDK already installed at the archive's API level. */
+    force?: boolean;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+    /** Scratch directory for the extract temporaries; see {@link InstallSdkOptions.tmpDir}. */
+    tmpDir?: string;
+}
+interface InstalledSdk {
+    /** API level, from the components' `oh-uni-package.json` (e.g. `26`). */
+    api: string;
+    /** SDK build version from the same file (e.g. `26.0.0.39`). */
+    version: string;
+    /** Where it was installed: `<sdkRootDir>/<os>/<api>`. */
+    dir: string;
+}
+/**
+ * Install an OpenHarmony SDK from a local tarball into `<sdkRootDir>/<os>/<api>`. This
+ * is how the full SDK, which the release mirror does not carry, gets installed.
+ *
+ * Only the current OS's folder is unpacked, wherever it sits in the archive (the full
+ * SDK packs `linux`, `ohos` and `windows` side by side under `ohos-sdk/`), and the API
+ * level is read from the components rather than taken from the caller.
+ *
+ * Progress budget (overall 0..100):
+ *   0..40  Tarball extract
+ *   40..95 Component ZIP extracts
+ *   95..100 Finalize + cleanup
+ */
+declare function installSdkFromArchive(opts: InstallSdkFromArchiveOptions): Promise<InstalledSdk>;
+/**
+ * The shallowest `<osFolder>` directory under `root` that holds component ZIPs, or
+ * undefined. SDK tarballs nest it at different depths (`windows/`, `ohos-sdk/windows/`,
+ * deeper on macOS).
+ */
+declare function findSdkOsDir(root: string, osFolder: OsFolder, maxDepth?: number): string | undefined;
 
 /**
  * Resolve the per-platform download URL for the OpenHarmony command-line tools.
@@ -1687,6 +1742,12 @@ declare function streamHilog(opts: StreamHilogOptions): ChildProcessWithoutNullS
 declare function parseHilogLine(line: string): HilogEntry | null;
 /** Collapse consecutive duplicate entries (same level/tag/message), ignoring time/pid. */
 declare function dedupEntries(entries: HilogEntry[]): HilogEntry[];
+/**
+ * A hilog `time` ("MM-DD HH:MM:SS.mmm", no year) as `Date.UTC` ms, in the year
+ * that puts it closest to `referenceMs`, so a December 31st line read on
+ * January 1st lands in the previous year. Null when `time` has another form.
+ */
+declare function hilogTimeMs(time: string, referenceMs: number): number | null;
 interface WaitForLogOptions {
     config: ConfigProvider;
     /** Tested against `"<tag>: <message>"` of each parsed line. */
@@ -1696,14 +1757,20 @@ interface WaitForLogOptions {
     bundle?: string;
     domain?: string | number;
     deviceSerial?: string;
+    /**
+     * Also match lines logged up to this long before the call. By default (0) only
+     * lines from the call onwards count, measured on the device clock to the second.
+     * `Infinity` matches everything still in the device buffer.
+     */
+    lookbackMs?: number;
     abortSignal?: AbortSignal;
     logger?: Logger;
 }
 /**
- * Resolve with the first hilog entry whose `"<tag>: <message>"` matches `pattern`.
- * The underlying stream is auto-respawned if it dies before the deadline, so the
- * wait survives a reboot mid-observation. Rejects on timeout (OniroError) or
- * abort (CancelledError).
+ * Resolve with the first hilog entry whose `"<tag>: <message>"` matches `pattern`
+ * and that was logged since the call (see `lookbackMs`). The underlying stream is
+ * auto-respawned if it dies before the deadline, so the wait survives a reboot
+ * mid-observation. Rejects on timeout (OniroError) or abort (CancelledError).
  */
 declare function waitForLog(opts: WaitForLogOptions): Promise<HilogEntry>;
 interface WatchLogOptions {
@@ -1716,10 +1783,15 @@ interface WatchLogOptions {
     deviceSerial?: string;
     /** Collapse consecutive duplicate lines. Default true. */
     dedup?: boolean;
+    /** Also collect lines logged up to this long before the call; see {@link WaitForLogOptions.lookbackMs}. */
+    lookbackMs?: number;
     abortSignal?: AbortSignal;
     logger?: Logger;
 }
-/** Collect all hilog entries matching `pattern` for `durationMs`. Deduped by default. */
+/**
+ * Collect the hilog entries matching `pattern` that are logged during `durationMs`
+ * (see `lookbackMs`). Deduped by default.
+ */
 declare function watchLog(opts: WatchLogOptions): Promise<HilogEntry[]>;
 interface CaptureLogOptions {
     config: ConfigProvider;
@@ -1833,10 +1905,12 @@ interface DiscoverHapsOptions {
 /**
  * Walk a project's build outputs and group `*-signed.hap` / `*-unsigned.hap`
  * by build module name (parsed from the HAP filename). Skips `node_modules` /
- * `oh_modules` / `.git`. Ported from the proven MCP `findHaps`, extended with
- * per-module grouping so multi-module projects can install the right HAP.
- * Each list is newest first, so a fresh build wins over HAPs committed to the
- * repository. Empty object when nothing is built.
+ * `oh_modules` / `.git`, and, when `projectDir` is an app project root, any
+ * other app project nested inside it, whose HAPs belong to another app.
+ * Ported from the proven MCP `findHaps`, extended with per-module grouping so
+ * multi-module projects can install the right HAP. Each list is newest first,
+ * so a fresh build wins over HAPs committed to the repository. Empty object
+ * when nothing is built.
  */
 declare function discoverHaps(opts: DiscoverHapsOptions): Promise<Record<string, ModuleHaps>>;
 interface PickedHap {
@@ -1936,6 +2010,12 @@ declare function cleanCodelinterOutput(output: string): string;
 declare function parseCodelinterReport(output: string): CodelinterReport;
 /** The findings of a codelinter report; see {@link parseCodelinterReport}. */
 declare function parseCodelinterFindings(output: string): CodelinterFinding[];
+/**
+ * Which of the project-root files codelinter needs are missing from `projectDir`,
+ * each named by its first form. Without them codelinter exits non-zero without a
+ * report, and says neither why nor which file.
+ */
+declare function missingProjectRootFiles(projectDir: string): string[];
 interface RunCodelinterOptions {
     config: ConfigProvider;
     projectDir: string;
@@ -2229,6 +2309,11 @@ interface ApplyChangesResult {
  */
 declare function applyChanges(opts: ApplyChangesOptions): Promise<ApplyChangesResult>;
 
+/** `app.bundleName` from the text of a HAP's `module.json` (stage model) or `config.json` (FA model), or null. */
+declare function bundleNameFromHapConfig(text: string): string | null;
+/** The bundle a HAP installs as, read from its `module.json` or `config.json`; null when neither names one. */
+declare function readHapBundleName(hapPath: string): Promise<string | null>;
+
 /**
  * Which runtime a project targets. OpenHarmony projects build against the public
  * OpenHarmony SDK; HarmonyOS projects build against Huawei's HarmonyOS SDK and
@@ -2525,4 +2610,4 @@ declare function harmonyOsAutoSign(opts: HarmonyOsAutoSignOptions): Promise<Harm
 
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, type CaptureLogOptions, type CaptureLogResult, ChecksumMismatchError, type CmdToolsFlavour, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterReport, type CodelinterResult, type CodelinterSummary, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type EmulatorStatus, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCandidate, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PickedHap, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, appSandboxDir, applyChanges, assertDevicePath, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, captureLog, cleanCodelinterOutput, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectCmdToolsFlavour, detectInstallFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diagnoseBuildFailure, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureInstallOk, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, existingHapOrUnsigned, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findMissingProjectSdk, findRunningProcess, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getEmulatorStatus, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcClientFailure, hdcExec, hdcTargetArgs, hdcTargetArgsFor, hideKeyboard, installApp, installCmdTools, installEmulator, installFailureReason, isBundleInstalled, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isUnsignedHap, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, normaliseLocalPath, paramGet, paramGetMany, paramSet, parseBounds, parseCodelinterFindings, parseCodelinterReport, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseParamValues, parseRemoteExit, performInput, pickHap, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readJson5File, readJsonFile, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveDeviceSerial, resolveKeyEvent, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, unsignedHapRejection, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, type CaptureLogOptions, type CaptureLogResult, ChecksumMismatchError, type CmdToolsFlavour, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterReport, type CodelinterResult, type CodelinterSummary, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type EmulatorStatus, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCandidate, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkFromArchiveOptions, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, type InstalledSdk, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_DAILY_BUILDS_URL, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PickedHap, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, appSandboxDir, applyChanges, assertDevicePath, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, bundleNameFromHapConfig, captureBurst, captureLog, cleanCodelinterOutput, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectCmdToolsFlavour, detectInstallFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diagnoseBuildFailure, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureInstallOk, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, existingHapOrUnsigned, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findMissingProjectSdk, findRunningProcess, findSdkOsDir, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getEmulatorStatus, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcClientFailure, hdcExec, hdcTargetArgs, hdcTargetArgsFor, hideKeyboard, hilogTimeMs, installApp, installCmdTools, installEmulator, installFailureReason, installSdkFromArchive, isBundleInstalled, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isUnsignedHap, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, missingProjectRootFiles, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, normaliseLocalPath, paramGet, paramGetMany, paramSet, parseBounds, parseCodelinterFindings, parseCodelinterReport, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseParamValues, parseRemoteExit, performInput, pickHap, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readHapBundleName, readJson5File, readJsonFile, readProvisionProfile, readZipEntry, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveDeviceSerial, resolveKeyEvent, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, unsignedHapRejection, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };

package/dist/index.d.ts

@@ -161,6 +161,12 @@ interface SdkRelease {
  */
 declare const ALL_SDKS: readonly SdkRelease[];
 declare const OHOS_URL_BASE = "https://repo.huaweicloud.com/openharmony/os";
+/**
+ * OpenHarmony daily builds. The full SDK (with `@systemapi` declarations) is not on the
+ * release mirror; its `ohos-sdk-full` archives are published here, to be installed with
+ * `installSdkFromArchive`.
+ */
+declare const OHOS_DAILY_BUILDS_URL = "https://dcp.openharmony.cn/workbench/cicd/dailybuild/dailylist";
 
 type OsFolder = 'linux' | 'darwin' | 'windows';
 /**
@@ -382,9 +388,15 @@ interface ExtractZipOptions {
  */
 declare function extractZipWithProgress(opts: ExtractZipOptions): Promise<void>;
 /**
- * Extract a tar/tar.gz/tar.bz2 archive. Wraps `tar.x`.
+ * Extract a tar/tar.gz/tar.bz2 archive. Wraps `tar.x`; `filter` receives each entry's
+ * archive path and skips the entry when it returns false.
  */
-declare function extractTarball(tarPath: string, dest: string, strip?: number): Promise<void>;
+declare function extractTarball(tarPath: string, dest: string, strip?: number, filter?: (entryPath: string) => boolean): Promise<void>;
+/**
+ * Contents of the first entry of a ZIP whose name `match` accepts, or undefined. Reads
+ * only the central directory and that entry, so it is cheap on multi-hundred-MB ZIPs.
+ */
+declare function readZipEntry(zipPath: string, match: (entryName: string) => boolean): Promise<Buffer | undefined>;
 
 interface SdkInfo {
     version: string;
@@ -434,6 +446,49 @@ interface InstallSdkOptions {
  *   95..100 Finalize + cleanup
  */
 declare function downloadAndInstallSdk(opts: InstallSdkOptions): Promise<void>;
+interface InstallSdkFromArchiveOptions {
+    config: ConfigProvider;
+    /**
+     * A local SDK tarball: an `ohos-sdk-full` archive from the daily builds
+     * (`OHOS_DAILY_BUILDS_URL`), or a public release downloaded by hand.
+     */
+    archivePath: string;
+    /** Replace an SDK already installed at the archive's API level. */
+    force?: boolean;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+    /** Scratch directory for the extract temporaries; see {@link InstallSdkOptions.tmpDir}. */
+    tmpDir?: string;
+}
+interface InstalledSdk {
+    /** API level, from the components' `oh-uni-package.json` (e.g. `26`). */
+    api: string;
+    /** SDK build version from the same file (e.g. `26.0.0.39`). */
+    version: string;
+    /** Where it was installed: `<sdkRootDir>/<os>/<api>`. */
+    dir: string;
+}
+/**
+ * Install an OpenHarmony SDK from a local tarball into `<sdkRootDir>/<os>/<api>`. This
+ * is how the full SDK, which the release mirror does not carry, gets installed.
+ *
+ * Only the current OS's folder is unpacked, wherever it sits in the archive (the full
+ * SDK packs `linux`, `ohos` and `windows` side by side under `ohos-sdk/`), and the API
+ * level is read from the components rather than taken from the caller.
+ *
+ * Progress budget (overall 0..100):
+ *   0..40  Tarball extract
+ *   40..95 Component ZIP extracts
+ *   95..100 Finalize + cleanup
+ */
+declare function installSdkFromArchive(opts: InstallSdkFromArchiveOptions): Promise<InstalledSdk>;
+/**
+ * The shallowest `<osFolder>` directory under `root` that holds component ZIPs, or
+ * undefined. SDK tarballs nest it at different depths (`windows/`, `ohos-sdk/windows/`,
+ * deeper on macOS).
+ */
+declare function findSdkOsDir(root: string, osFolder: OsFolder, maxDepth?: number): string | undefined;
 
 /**
  * Resolve the per-platform download URL for the OpenHarmony command-line tools.
@@ -1687,6 +1742,12 @@ declare function streamHilog(opts: StreamHilogOptions): ChildProcessWithoutNullS
 declare function parseHilogLine(line: string): HilogEntry | null;
 /** Collapse consecutive duplicate entries (same level/tag/message), ignoring time/pid. */
 declare function dedupEntries(entries: HilogEntry[]): HilogEntry[];
+/**
+ * A hilog `time` ("MM-DD HH:MM:SS.mmm", no year) as `Date.UTC` ms, in the year
+ * that puts it closest to `referenceMs`, so a December 31st line read on
+ * January 1st lands in the previous year. Null when `time` has another form.
+ */
+declare function hilogTimeMs(time: string, referenceMs: number): number | null;
 interface WaitForLogOptions {
     config: ConfigProvider;
     /** Tested against `"<tag>: <message>"` of each parsed line. */
@@ -1696,14 +1757,20 @@ interface WaitForLogOptions {
     bundle?: string;
     domain?: string | number;
     deviceSerial?: string;
+    /**
+     * Also match lines logged up to this long before the call. By default (0) only
+     * lines from the call onwards count, measured on the device clock to the second.
+     * `Infinity` matches everything still in the device buffer.
+     */
+    lookbackMs?: number;
     abortSignal?: AbortSignal;
     logger?: Logger;
 }
 /**
- * Resolve with the first hilog entry whose `"<tag>: <message>"` matches `pattern`.
- * The underlying stream is auto-respawned if it dies before the deadline, so the
- * wait survives a reboot mid-observation. Rejects on timeout (OniroError) or
- * abort (CancelledError).
+ * Resolve with the first hilog entry whose `"<tag>: <message>"` matches `pattern`
+ * and that was logged since the call (see `lookbackMs`). The underlying stream is
+ * auto-respawned if it dies before the deadline, so the wait survives a reboot
+ * mid-observation. Rejects on timeout (OniroError) or abort (CancelledError).
  */
 declare function waitForLog(opts: WaitForLogOptions): Promise<HilogEntry>;
 interface WatchLogOptions {
@@ -1716,10 +1783,15 @@ interface WatchLogOptions {
     deviceSerial?: string;
     /** Collapse consecutive duplicate lines. Default true. */
     dedup?: boolean;
+    /** Also collect lines logged up to this long before the call; see {@link WaitForLogOptions.lookbackMs}. */
+    lookbackMs?: number;
     abortSignal?: AbortSignal;
     logger?: Logger;
 }
-/** Collect all hilog entries matching `pattern` for `durationMs`. Deduped by default. */
+/**
+ * Collect the hilog entries matching `pattern` that are logged during `durationMs`
+ * (see `lookbackMs`). Deduped by default.
+ */
 declare function watchLog(opts: WatchLogOptions): Promise<HilogEntry[]>;
 interface CaptureLogOptions {
     config: ConfigProvider;
@@ -1833,10 +1905,12 @@ interface DiscoverHapsOptions {
 /**
  * Walk a project's build outputs and group `*-signed.hap` / `*-unsigned.hap`
  * by build module name (parsed from the HAP filename). Skips `node_modules` /
- * `oh_modules` / `.git`. Ported from the proven MCP `findHaps`, extended with
- * per-module grouping so multi-module projects can install the right HAP.
- * Each list is newest first, so a fresh build wins over HAPs committed to the
- * repository. Empty object when nothing is built.
+ * `oh_modules` / `.git`, and, when `projectDir` is an app project root, any
+ * other app project nested inside it, whose HAPs belong to another app.
+ * Ported from the proven MCP `findHaps`, extended with per-module grouping so
+ * multi-module projects can install the right HAP. Each list is newest first,
+ * so a fresh build wins over HAPs committed to the repository. Empty object
+ * when nothing is built.
  */
 declare function discoverHaps(opts: DiscoverHapsOptions): Promise<Record<string, ModuleHaps>>;
 interface PickedHap {
@@ -1936,6 +2010,12 @@ declare function cleanCodelinterOutput(output: string): string;
 declare function parseCodelinterReport(output: string): CodelinterReport;
 /** The findings of a codelinter report; see {@link parseCodelinterReport}. */
 declare function parseCodelinterFindings(output: string): CodelinterFinding[];
+/**
+ * Which of the project-root files codelinter needs are missing from `projectDir`,
+ * each named by its first form. Without them codelinter exits non-zero without a
+ * report, and says neither why nor which file.
+ */
+declare function missingProjectRootFiles(projectDir: string): string[];
 interface RunCodelinterOptions {
     config: ConfigProvider;
     projectDir: string;
@@ -2229,6 +2309,11 @@ interface ApplyChangesResult {
  */
 declare function applyChanges(opts: ApplyChangesOptions): Promise<ApplyChangesResult>;
 
+/** `app.bundleName` from the text of a HAP's `module.json` (stage model) or `config.json` (FA model), or null. */
+declare function bundleNameFromHapConfig(text: string): string | null;
+/** The bundle a HAP installs as, read from its `module.json` or `config.json`; null when neither names one. */
+declare function readHapBundleName(hapPath: string): Promise<string | null>;
+
 /**
  * Which runtime a project targets. OpenHarmony projects build against the public
  * OpenHarmony SDK; HarmonyOS projects build against Huawei's HarmonyOS SDK and
@@ -2525,4 +2610,4 @@ declare function harmonyOsAutoSign(opts: HarmonyOsAutoSignOptions): Promise<Harm
 
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, type CaptureLogOptions, type CaptureLogResult, ChecksumMismatchError, type CmdToolsFlavour, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterReport, type CodelinterResult, type CodelinterSummary, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type EmulatorStatus, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCandidate, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PickedHap, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, appSandboxDir, applyChanges, assertDevicePath, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, captureLog, cleanCodelinterOutput, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectCmdToolsFlavour, detectInstallFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diagnoseBuildFailure, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureInstallOk, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, existingHapOrUnsigned, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findMissingProjectSdk, findRunningProcess, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getEmulatorStatus, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcClientFailure, hdcExec, hdcTargetArgs, hdcTargetArgsFor, hideKeyboard, installApp, installCmdTools, installEmulator, installFailureReason, isBundleInstalled, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isUnsignedHap, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, normaliseLocalPath, paramGet, paramGetMany, paramSet, parseBounds, parseCodelinterFindings, parseCodelinterReport, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseParamValues, parseRemoteExit, performInput, pickHap, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readJson5File, readJsonFile, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveDeviceSerial, resolveKeyEvent, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, unsignedHapRejection, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, type CaptureLogOptions, type CaptureLogResult, ChecksumMismatchError, type CmdToolsFlavour, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterReport, type CodelinterResult, type CodelinterSummary, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type EmulatorStatus, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCandidate, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkFromArchiveOptions, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, type InstalledSdk, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_DAILY_BUILDS_URL, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PickedHap, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, appSandboxDir, applyChanges, assertDevicePath, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, bundleNameFromHapConfig, captureBurst, captureLog, cleanCodelinterOutput, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectCmdToolsFlavour, detectInstallFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diagnoseBuildFailure, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureInstallOk, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, existingHapOrUnsigned, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findMissingProjectSdk, findRunningProcess, findSdkOsDir, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getEmulatorStatus, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcClientFailure, hdcExec, hdcTargetArgs, hdcTargetArgsFor, hideKeyboard, hilogTimeMs, installApp, installCmdTools, installEmulator, installFailureReason, installSdkFromArchive, isBundleInstalled, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isUnsignedHap, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, missingProjectRootFiles, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, normaliseLocalPath, paramGet, paramGetMany, paramSet, parseBounds, parseCodelinterFindings, parseCodelinterReport, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseParamValues, parseRemoteExit, performInput, pickHap, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readHapBundleName, readJson5File, readJsonFile, readProvisionProfile, readZipEntry, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveDeviceSerial, resolveKeyEvent, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, unsignedHapRejection, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };