Files
openclaw/scripts/check-memory-fd-repro.d.mts
Peter Steinberger fe261b0f59 chore(tooling): typecheck root test/** with a dedicated tsgo lane (#104475)
* chore(types): add declaration files for scripts/lib and scripts/e2e modules

* chore(types): add declaration files for top-level script modules (a-m)

* chore(types): add declaration files for top-level script modules (n-z)

* test: use a non-secret-shaped gateway token fixture

* test: type ci workflow guard helpers for the root test lane

* chore(tooling): typecheck root test/** with a dedicated tsgo lane

- test/tsconfig/tsconfig.test.root.json: root-test program (strict unused checks,
  fixtures excluded; two Docker E2E clients that import built dist/** stay out,
  same rationale as the scripts/e2e exclusion in tsconfig.scripts.json)
- tsgo:test:root wired into tsgo:test, check:test-types, scripts/check.mjs, and
  the ci.yml test-types shard, mirroring the tsgo:scripts lane (#104348)
- changed-lane routing: test/**/*.ts (excluding fixtures) and the lane tsconfig
  now trigger 'typecheck test root' in check:changed; previously test/ paths ran
  lint only, so harness type errors surfaced first in CI (#104287 envDir case)
- burn down all 1071 latent type errors in the program: precise param/local
  types across test/scripts, test/vitest, test/e2e, and transitive scripts/e2e
  program members; 205 sibling .d.mts declaration files for imported .mjs
  modules (committed separately); zero any, zero ts-expect-error
- resolve the pre-existing testing star-export ambiguity in
  scripts/e2e/parallels/common.ts with an explicit re-export

Closes #104388

* chore(types): correct declaration fidelity per structured review

- re-derive 51 .d.mts files from implementation data flow instead of
  initializers: fix a wrong never return (runTestProjectsDelegation returns
  the child), add encoding-sensitive exec/spawn overloads (plain-gh), restore
  the full release profile union, make parsed paths string | null, add missing
  parseArgs fields via help/non-help unions, add a missing sibling declaration
  (budget-number-args), drop 15 unused lint directives
- precise install-record/tuple typing removes the type-aware oxlint
  regressions the first declarations caused in scripts/e2e implementations
- route .mts declaration edits under test/ to the testRoot lane and reference
  the test-root project from tsconfig.projects.json so tsgo:all covers it
  (closes both review findings against the lane wiring)

* chore(scripts): keep telegram runner dist typing structural for the boundary guard

* chore(types): declare runtime pack and gateway readiness exports added on main

* test: pin the importTargetPlan form of the plugin-contract plan import

The guard expectation still referenced the raw await import( form that
7ae5996bb3 (#103975) replaced with the importTargetPlan fallback helper;
the assertion fails on current main.
2026-07-11 06:15:41 -07:00

193 lines
4.4 KiB
TypeScript

#!/usr/bin/env node
/**
* Parses a safe non-negative integer option.
*/
export function readNumber(value: unknown, label: unknown): number;
/**
* Parses a safe positive integer option.
*/
export function readPositiveNumber(value: unknown, label: unknown): number;
/**
* Parses memory FD repro CLI arguments and environment fallbacks.
*/
export function parseArgs(argv: string[]): {
fileCount: number;
mode: "fixed" | "leak" | "report";
maxWorkspaceRegFds: number;
minLeakedFds: number;
invokeTimeoutMs: number;
sampleDelayMs: number;
settleDelayMs: number;
outputDir: string;
keep: boolean;
allowNonDarwin: boolean;
};
/**
* Writes isolated OpenClaw config for the synthetic memory workspace.
*/
export function writeConfig({
homeDir,
workspaceDir,
port,
token,
}: {
homeDir: unknown;
workspaceDir: unknown;
port: unknown;
token: unknown;
}): string;
/**
* Updates bounded gateway-ready output state from a stdout/stderr chunk.
*/
export function updateGatewayReadyOutputState(
state: unknown,
chunk: unknown,
maxChars?: number,
): {
tail: string;
readySeen: boolean;
};
/**
* Reports whether a spawned child has already exited.
*/
export function hasChildExited(child: unknown): boolean;
/**
* Waits until gateway output and listener state both indicate readiness.
*/
export function waitForGatewayReady({
child,
port,
logPath,
timeoutMs,
}: {
child: unknown;
port: unknown;
logPath: unknown;
timeoutMs: unknown;
}): Promise<void>;
/**
* Stops the gateway child using the default process/runtime hooks.
*/
export function stopGateway({ child, port }: { child: unknown; port: unknown }): Promise<void>;
/**
* Stops the gateway child and unknown remaining listener process.
*/
export function stopGatewayWithRuntime({
child,
childExitPollIntervalMs,
childExitPolls,
port,
findGatewayPidFn,
killProcess,
listenerSettleDelayMs,
}: {
child: unknown;
childExitPollIntervalMs?: number | undefined;
childExitPolls?: number | undefined;
port: unknown;
findGatewayPidFn: unknown;
killProcess: unknown;
listenerSettleDelayMs?: number | undefined;
}): Promise<void>;
/**
* Classifies the memory_search HTTP response into success/error details.
*/
export function classifyMemorySearchInvokeResponse({
httpOk,
status,
bodyText,
}: {
httpOk: unknown;
status: unknown;
bodyText: unknown;
}):
| {
ok: boolean;
httpOk: unknown;
status: unknown;
gatewayOk: boolean | undefined;
error: string;
}
| {
ok: boolean;
httpOk: unknown;
status: unknown;
error: string;
gatewayOk?: undefined;
}
| {
error?: string | undefined;
toolError?: string | undefined;
ok: boolean;
httpOk: unknown;
status: unknown;
gatewayOk: boolean | undefined;
resultCount: unknown;
toolDisabled: boolean;
toolUnavailable: boolean;
};
export function invokeMemorySearch({
port,
token,
timeoutMs,
}: {
port: unknown;
token: unknown;
timeoutMs: unknown;
}): Promise<
| {
durationMs: number;
bodyPreview: string;
ok: boolean;
httpOk: unknown;
status: unknown;
gatewayOk: boolean | undefined;
error: string;
aborted?: undefined;
}
| {
durationMs: number;
bodyPreview: string;
ok: boolean;
httpOk: unknown;
status: unknown;
error: string;
gatewayOk?: undefined;
aborted?: undefined;
}
| {
durationMs: number;
bodyPreview: string;
error?: string | undefined;
toolError?: string | undefined;
ok: boolean;
httpOk: unknown;
status: unknown;
gatewayOk: boolean | undefined;
resultCount: unknown;
toolDisabled: boolean;
toolUnavailable: boolean;
aborted?: undefined;
}
| {
ok: boolean;
aborted: boolean;
durationMs: number;
error: string;
}
>;
/**
* Maximum gateway-ready output tail retained while waiting for startup.
*/
export const GATEWAY_READY_OUTPUT_MAX_CHARS: number;
/**
* Maximum bytes read from the memory_search HTTP response.
*/
export const MEMORY_SEARCH_RESPONSE_MAX_BYTES: number;
/**
* Probe query expected to hit the synthetic top-level memory file.
*/
export const MEMORY_SEARCH_PROBE_QUERY: "Top-level memory file";
export { readBoundedResponseText };
import { readBoundedResponseText } from "./lib/bounded-response.mjs";