mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-16 15:41:44 +00:00
* 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.
196 lines
6.2 KiB
TypeScript
196 lines
6.2 KiB
TypeScript
export function shouldPrintHelp(argv: string[]): boolean;
|
|
export function validateCliArgs(argv: string[]): void;
|
|
export function readPositiveInt(raw: string | undefined, fallback: number, label?: string): number;
|
|
export function readPositiveTimerMs(
|
|
raw: string | undefined,
|
|
fallback: number,
|
|
label?: string,
|
|
): number;
|
|
export function resolveKitchenSinkRpcConfig(env?: NodeJS.ProcessEnv): {
|
|
commandMaxRssMiB: number;
|
|
commandTimeoutMs: number;
|
|
fetchBodyMaxBytes: number;
|
|
fetchTimeoutMs: number;
|
|
installTimeoutMs: number;
|
|
maxRssMiB: number;
|
|
outputCaptureChars: number;
|
|
readyTimeoutMs: number;
|
|
rpcTimeoutMs: number;
|
|
};
|
|
export function resolveKitchenSinkRpcPort(
|
|
env?: NodeJS.ProcessEnv,
|
|
options?: { findAvailablePort?: () => Promise<number> },
|
|
): Promise<number>;
|
|
export function makeEnv(): {
|
|
root: string;
|
|
env: {
|
|
HOME: string;
|
|
USERPROFILE: string;
|
|
OPENCLAW_HOME: string;
|
|
OPENCLAW_STATE_DIR: string;
|
|
OPENCLAW_CONFIG_PATH: string;
|
|
OPENCLAW_NO_ONBOARD: string;
|
|
OPENCLAW_SKIP_PROVIDERS: string;
|
|
OPENCLAW_KITCHEN_SINK_PERSONALITY: string;
|
|
};
|
|
};
|
|
export function cleanupKitchenSinkEnv(
|
|
root: string,
|
|
options?: {
|
|
attempts?: number;
|
|
delayMs?: number;
|
|
throwOnFailure?: boolean;
|
|
warn?: boolean;
|
|
},
|
|
): Promise<boolean>;
|
|
export function appendBoundedOutput(
|
|
buffer: { text: string; truncatedChars: number },
|
|
chunk: string | Uint8Array,
|
|
maxChars?: number,
|
|
): {
|
|
text: string;
|
|
truncatedChars: number;
|
|
};
|
|
export function runCommand(
|
|
command: string,
|
|
args: string[],
|
|
options?: Record<string, unknown>,
|
|
): Promise<{
|
|
stderr: string;
|
|
stdout: string;
|
|
stderrTruncatedChars: number;
|
|
stdoutTruncatedChars: number;
|
|
}>;
|
|
export function signalProcessGroup(
|
|
child: { pid?: number; kill(signal?: NodeJS.Signals): unknown },
|
|
signal: NodeJS.Signals,
|
|
{
|
|
platform,
|
|
runTaskkill,
|
|
useProcessGroup,
|
|
}?: {
|
|
platform?: NodeJS.Platform | undefined;
|
|
runTaskkill?:
|
|
| ((
|
|
command: string,
|
|
args: string[],
|
|
options: { stdio: "ignore" },
|
|
) => { error?: Error; status: number | null })
|
|
| undefined;
|
|
useProcessGroup?: boolean | undefined;
|
|
},
|
|
): void;
|
|
export function parseJsonOutput(stdout: string): Record<string, unknown>;
|
|
export function parseGatewayCliRequestFailure(error: unknown):
|
|
| (Error & {
|
|
retryAfterMs?: number;
|
|
retryable: boolean;
|
|
details?: Record<string, unknown>;
|
|
name: string;
|
|
gatewayCode: string;
|
|
})
|
|
| null;
|
|
export function unwrapRpcPayload(raw: unknown): Record<string, unknown>;
|
|
export function createRpcCliRunOptions(
|
|
method: string,
|
|
options?: { env?: NodeJS.ProcessEnv; commandResourceOptions?: Record<string, unknown> },
|
|
): Record<string, unknown> & { resourceLabel: string; timeoutMs: number };
|
|
export function findDistCallGatewayModuleFiles(cwd?: string): string[];
|
|
export function usesBuiltOpenClawEntry(
|
|
runner: unknown,
|
|
cwd?: string,
|
|
env?: NodeJS.ProcessEnv,
|
|
): boolean;
|
|
export function fetchJson(
|
|
url: unknown,
|
|
options?: Record<string, unknown>,
|
|
): Promise<{
|
|
ok: unknown;
|
|
status: unknown;
|
|
body: unknown;
|
|
}>;
|
|
export function readBoundedResponseText(
|
|
response: unknown,
|
|
byteLimit: number,
|
|
timeoutPromise?: Promise<never>,
|
|
): Promise<string>;
|
|
export function stopGateway(child: unknown, options?: Record<string, unknown>): Promise<void>;
|
|
export function hasChildExited(child: unknown): boolean;
|
|
export function signalGateway(
|
|
child: unknown,
|
|
signal: unknown,
|
|
killProcess?: typeof defaultKillProcess,
|
|
options?: Record<string, unknown>,
|
|
): boolean;
|
|
export function createGatewayReadyLogScanner(logPath: unknown, marker?: string): () => boolean;
|
|
export function waitForGatewayReady(
|
|
child: unknown,
|
|
port: unknown,
|
|
logPath: unknown,
|
|
options?: Record<string, unknown>,
|
|
): Promise<void>;
|
|
export function extractPluginCommandNames(payload: unknown): unknown[];
|
|
export function assertExpectedKitchenSinkToolEntries(
|
|
entries: unknown,
|
|
label: unknown,
|
|
{
|
|
requirePluginProvenance,
|
|
}?: {
|
|
requirePluginProvenance?: boolean | undefined;
|
|
},
|
|
): unknown;
|
|
export function assertChannelAccountRunning(payload: unknown): unknown;
|
|
export function extractTtsProviderIds(payload: unknown, surface: unknown): unknown[];
|
|
export function assertTtsProviderCoverage(payload: unknown, surface: unknown): void;
|
|
export function assertKitchenSinkSearchInvokeResult(payload: unknown): void;
|
|
export function assertKitchenSinkTextInvokeResult(payload: unknown): void;
|
|
export function assertKitchenSinkImageJobInvokeResult(payload: unknown): void;
|
|
export function listKitchenSinkToolInvokeNames(): string[];
|
|
export function listKitchenSinkReadOnlyRpcProbeNames(): string[];
|
|
export function listKitchenSinkAuthorizationRpcProbeNames(): string[];
|
|
export function assertOperatorRpcDenied(probe: unknown, call: unknown): Promise<void>;
|
|
export function assertCreatedKitchenSinkSession(payload: unknown, expectedKey?: string): unknown;
|
|
export function assertKitchenSinkUiDescriptors(
|
|
payload: unknown,
|
|
options?: Record<string, unknown>,
|
|
): unknown;
|
|
export function assertDiagnosticStabilityClean(payload: unknown): void;
|
|
export function assertGatewayHealthPayload(payload: unknown): void;
|
|
export function assertGatewayStatusPayload(payload: unknown): void;
|
|
export function sampleProcess(
|
|
pid: unknown,
|
|
options?: Record<string, unknown>,
|
|
): Promise<{
|
|
aggregateRssMiB: number;
|
|
rssMiB: number;
|
|
cpuPercent: unknown;
|
|
processId: unknown;
|
|
} | null>;
|
|
export function summarizeProcessSamples(samples: unknown): unknown;
|
|
export function sampleWindowsProcessByPort(
|
|
port: unknown,
|
|
options?: Record<string, unknown>,
|
|
): Promise<
|
|
| {
|
|
rssMiB: number;
|
|
aggregateRssMiB: number;
|
|
cpuPercent: null;
|
|
cpuSeconds: number | null;
|
|
processId: number;
|
|
}
|
|
| {
|
|
rssMiB: number;
|
|
cpuPercent: null;
|
|
cpuSeconds: null;
|
|
processId: number;
|
|
}
|
|
| null
|
|
>;
|
|
export function assertResourceCeiling(sample: unknown): void;
|
|
export function assertCommandResourceCeiling(sample: unknown): void;
|
|
export function findErrorLogFindings(logPath: string): Array<{ line: string; lineNumber: number }>;
|
|
export function tailFile(file: string, maxBytes?: number): string;
|
|
export function main(): Promise<void>;
|
|
export const MAX_KITCHEN_SINK_TIMER_TIMEOUT_MS: 2147000000;
|
|
declare function defaultKillProcess(pid: unknown, signal: unknown): true;
|