@compforge/harness-toolbox 0.4.5 → 0.4.8

package/dist/{chunk-2171tajs.js → chunk-1ts7pswj.js}

@@ -2,13 +2,13 @@ import {
   findPodsForService,
   findService,
   listServiceNetwork
-} from "./chunk-j46x7j7c.js";
+} from "./chunk-xgnz10sr.js";
 import {
   findPod
 } from "./chunk-6fnhzhdb.js";
 import {
   PortForwardScope
-} from "./chunk-631vce5z.js";
+} from "./chunk-nftzckdy.js";
 
 // src/kubernetes/service-port-forward.ts
 class ServicePortForwarder {
@@ -24,13 +24,14 @@ class ServicePortForwarder {
     this.#scope = new PortForwardScope(starter);
   }
   static async create(executor, opts, starter) {
-    const network = await listServiceNetwork(executor, opts.namespace);
+    const network = await listServiceNetwork(executor, opts.namespace, opts.signal);
     return new ServicePortForwarder(opts, network.services, network.pods, starter);
   }
   get activeForwards() {
     return this.#scope.active;
   }
   forward(endpoint) {
+    this.opts.signal?.throwIfAborted();
     const key = `${endpoint.host}:${endpoint.port}`;
     let pending = this.#cache.get(key);
     if (!pending) {

package/dist/{chunk-mn6dwsvh.js → chunk-9shz0bw1.js}

@@ -24,7 +24,9 @@ function spawnProcess(argv, opts) {
     stdout: Readable.toWeb(child.stdout),
     stderr: Readable.toWeb(child.stderr),
     exited,
-    kill: () => child.kill()
+    kill: (signal) => {
+      child.kill(signal);
+    }
   };
 }
 function sleep(ms) {

package/dist/{chunk-wv4jwhvj.js → chunk-fqrknvr8.js}

@@ -1,9 +1,9 @@
 import {
   startPortForward
-} from "./chunk-631vce5z.js";
+} from "./chunk-nftzckdy.js";
 import {
   KubectlExecutor
-} from "./chunk-hmah9t8e.js";
+} from "./chunk-rq5fc007.js";
 import {
   POD_RELAY_SCRIPT
 } from "./chunk-ssj93brx.js";

package/dist/{chunk-g2bac2jd.js → chunk-m391jmpw.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-ae84rzq5.js";
 import {
   ServicePortForwarder
-} from "./chunk-2171tajs.js";
+} from "./chunk-1ts7pswj.js";
 import {
   KubernetesResourceTransport
 } from "./chunk-x0yhfg29.js";
@@ -15,7 +15,7 @@ import {
 } from "./chunk-rkt41za2.js";
 import {
   KubectlExecutor
-} from "./chunk-hmah9t8e.js";
+} from "./chunk-rq5fc007.js";
 
 // src/kubernetes/client.ts
 class KubernetesClient {

package/dist/{chunk-631vce5z.js → chunk-nftzckdy.js}

@@ -1,12 +1,13 @@
 import {
   buildKubectlArgs
-} from "./chunk-hmah9t8e.js";
+} from "./chunk-rq5fc007.js";
 import {
   spawnProcess
-} from "./chunk-mn6dwsvh.js";
+} from "./chunk-9shz0bw1.js";
 
 // src/kubernetes/port-forward.ts
 async function startPortForward(opts) {
+  opts.signal?.throwIfAborted();
   const target = opts.target ?? (opts.service ? { kind: "service", name: opts.service } : undefined);
   if (!target)
     return { ok: false, reason: "port-forward 缺少 Service/Pod 目标" };
@@ -24,8 +25,51 @@ async function startPortForward(opts) {
     return { ok: false, reason: err instanceof Error ? err.message : String(err) };
   }
   const timeoutMs = opts.timeoutMs ?? 15000;
-  const stderrPromise = new Response(proc.stderr).text();
+  const log = opts.onDiagnostic ?? (() => {});
+  const started = Date.now();
+  log(`port-forward start target=${target.kind}/${target.name} namespace=${opts.namespace ?? "default"} remote_port=${opts.remotePort} timeout_ms=${timeoutMs}`);
+  let stderr = "";
+  let loggedBytes = 0;
+  const stderrReader = proc.stderr.getReader();
+  const stderrDone = (async () => {
+    const decoder2 = new TextDecoder;
+    for (;; ) {
+      const chunk = await stderrReader.read();
+      if (chunk.done)
+        break;
+      const text = decoder2.decode(chunk.value, { stream: true }).replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/g, "$1[redacted]@").replace(/([?&](?:token|password|secret|key)=)[^&\s]+/gi, "$1[redacted]").replace(/((?:authorization|password|token)[:=]\s*)[^\r\n]+/gi, "$1[redacted]");
+      stderr = (stderr + text).slice(-8192);
+      if (loggedBytes < 8192) {
+        const diagnostic = text.slice(0, 8192 - loggedBytes);
+        loggedBytes += diagnostic.length;
+        log(`port-forward stderr: ${diagnostic.trim()}`);
+      }
+    }
+  })().catch(() => {});
+  let stopped = false;
+  let cancelWait;
+  const cancelled = new Promise((resolve) => {
+    cancelWait = () => resolve("cancelled");
+  });
+  const abort = () => {
+    log(`port-forward cancelled elapsed_ms=${Date.now() - started}`);
+    stop();
+    cancelWait();
+  };
+  const stop = () => {
+    if (stopped)
+      return;
+    stopped = true;
+    opts.signal?.removeEventListener("abort", abort);
+    proc.kill("SIGKILL");
+    stderrReader.cancel().catch(() => {});
+    reader.cancel().catch(() => {});
+  };
   const reader = proc.stdout.getReader();
+  opts.signal?.addEventListener("abort", abort, { once: true });
+  if (opts.signal?.aborted)
+    abort();
+  proc.exited.then(() => opts.signal?.removeEventListener("abort", abort), () => opts.signal?.removeEventListener("abort", abort));
   const decoder = new TextDecoder;
   const deadline = Date.now() + timeoutMs;
   let out = "";
@@ -36,6 +80,7 @@ async function startPortForward(opts) {
     let timer;
     const chunk = await Promise.race([
       reader.read(),
+      cancelled,
       new Promise((resolve) => {
         timer = setTimeout(() => resolve("timeout"), remain);
       }),
@@ -43,10 +88,13 @@ async function startPortForward(opts) {
     ]).finally(() => {
       clearTimeout(timer);
     });
+    opts.signal?.throwIfAborted();
+    if (chunk === "cancelled")
+      throw opts.signal?.reason;
     if (chunk === "timeout")
       break;
     if (typeof chunk === "object" && "error" in chunk) {
-      proc.kill();
+      stop();
       return { ok: false, reason: chunk.error instanceof Error ? chunk.error.message : String(chunk.error) };
     }
     if (chunk === "exited" || chunk.done)
@@ -54,16 +102,18 @@ async function startPortForward(opts) {
     out += decoder.decode(chunk.value);
     const m = out.match(/Forwarding from 127\.0\.0\.1:(\d+)/);
     if (m) {
+      log(`port-forward listening local=127.0.0.1:${m[1]} elapsed_ms=${Date.now() - started}`);
       return {
         ok: true,
-        value: { target, localPort: Number(m[1]), command: argv, stop: () => proc.kill() }
+        value: { target, localPort: Number(m[1]), command: argv, stop }
       };
     }
   }
-  proc.kill();
-  const stderr = await stderrPromise.catch(() => "");
+  await Promise.resolve();
+  stop();
   const reason = stderr.trim().split(`
 `)[0] || `port-forward 未就绪（${timeoutMs}ms 超时）`;
+  log(`port-forward failed elapsed_ms=${Date.now() - started} reason=${reason}`);
   return { ok: false, reason };
 }
 

package/dist/{chunk-hmah9t8e.js → chunk-rq5fc007.js}

@@ -1,6 +1,6 @@
 import {
   spawnProcess
-} from "./chunk-mn6dwsvh.js";
+} from "./chunk-9shz0bw1.js";
 
 // src/kubernetes/executor.ts
 function buildKubectlArgs(opts, sub) {

package/dist/{chunk-sbt20n84.js → chunk-vymm4g9h.js}

@@ -3,6 +3,7 @@ import {
   awaitWithSignal
 } from "./chunk-gm4swndx.js";
 import {
+  TimeoutError,
   ToolboxError
 } from "./chunk-rkt41za2.js";
 import {
@@ -11,6 +12,25 @@ import {
 
 // src/opensearch/client.ts
 import { Client, Connection, errors } from "@opensearch-project/opensearch";
+function describeOpenSearchError(error) {
+  const parts = [];
+  const seen = new Set;
+  while (error && typeof error === "object" && !seen.has(error) && parts.length < 4) {
+    seen.add(error);
+    const value = error;
+    const safe = (value2) => typeof value2 === "number" ? String(value2) : typeof value2 === "string" && /^[a-zA-Z0-9_.-]{1,80}$/.test(value2) ? value2 : undefined;
+    const argument = (value.code === "ERR_INVALID_ARG_VALUE" || value.code === "ERR_INVALID_ARG_TYPE") && typeof value.message === "string" ? value.message.match(/^The ["']([a-zA-Z][a-zA-Z0-9_.]{0,79})["'] (?:argument|option|property)/)?.[1] ?? value.message.match(/^The (?:argument|option|property) ["']([a-zA-Z][a-zA-Z0-9_.]{0,79})["']/)?.[1] : undefined;
+    parts.push([
+      `error=${safe(value.name) ?? "Error"}`,
+      argument && `argument=${argument}`,
+      safe(value.code) && `code=${safe(value.code)}`,
+      safe(value.kind) && `kind=${safe(value.kind)}`,
+      safe(value.statusCode ?? value.meta?.statusCode) && `status=${safe(value.statusCode ?? value.meta?.statusCode)}`
+    ].filter(Boolean).join(" "));
+    error = value.cause;
+  }
+  return parts.join(" cause=") || "error=UnknownError";
+}
 function isOpenSearchReadApi(search) {
   return typeof search.request === "function";
 }
@@ -33,8 +53,10 @@ function createClient(options) {
 }
 
 class OpenSearchEngine {
+  options;
   client;
   constructor(options, client) {
+    this.options = options;
     this.client = client ?? createClient(options);
   }
   async count(index, query) {
@@ -55,21 +77,39 @@ class OpenSearchEngine {
     });
     return response.body;
   }
-  async ping(signal, timeoutMs) {
+  async ping(signal, timeoutMs = this.options.requestTimeoutMs ?? 60000) {
     signal?.throwIfAborted();
-    const request = this.client.ping({}, timeoutMs === undefined ? undefined : { requestTimeout: timeoutMs });
-    const abort = () => {
-      request.abort?.();
-    };
-    signal?.addEventListener("abort", abort, { once: true });
+    const started = Date.now();
+    const url = new URL(this.options.node);
+    const target = `${url.protocol}//${url.host}`;
+    const log = this.options.onDiagnostic ?? (() => {});
+    log(`OpenSearch probe start target=${target} timeout_ms=${timeoutMs}`);
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(new TimeoutError(`OpenSearch probe timed out after ${timeoutMs}ms`)), timeoutMs);
+    const active = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
     try {
-      return await request;
+      const request = this.client.ping({}, { requestTimeout: timeoutMs });
+      const result = await awaitWithSignal(request, active, () => request.abort?.());
+      log(`OpenSearch probe ok target=${target} elapsed_ms=${Date.now() - started}`);
+      return result;
+    } catch (error) {
+      log(`OpenSearch probe failed target=${target} elapsed_ms=${Date.now() - started} ${describeOpenSearchError(error)}`);
+      throw error;
     } finally {
-      signal?.removeEventListener("abort", abort);
+      clearTimeout(timer);
     }
   }
-  close() {
-    return this.client.close();
+  async close() {
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(new TimeoutError("OpenSearch close timed out after 2000ms")), 2000);
+    try {
+      await awaitWithSignal(this.client.close(), controller.signal);
+    } catch (error) {
+      this.options.onDiagnostic?.(`OpenSearch close failed ${describeOpenSearchError(error)}`);
+      throw error;
+    } finally {
+      clearTimeout(timer);
+    }
   }
 }
 function openSearchRetryReason(error) {
@@ -112,6 +152,7 @@ class OpenSearchClient {
           open: async (transport, attempt) => {
             if (transport.kind !== "tcp")
               throw new Error("OpenSearch requires a TCP transport");
+            this.lifecycle.onDiagnostic?.(`OpenSearch route start transport=${transport.name} target=${original.protocol}//${original.host} timeout_ms=${attempt.remainingMs()}`);
             const endpoint = await transport.connect({
               host: original.hostname,
               port: Number(original.port || (original.protocol === "https:" ? 443 : 80)),
@@ -121,12 +162,14 @@ class OpenSearchClient {
             const url = new URL(original);
             url.hostname = endpoint.host;
             url.port = String(endpoint.port);
-            const engine = new OpenSearchEngine({ ...target, node: url.toString(), servername: endpoint.servername ?? target.servername ?? original.hostname });
+            const engine = new OpenSearchEngine({ ...target, onDiagnostic: this.lifecycle.onDiagnostic, node: url.toString(), servername: endpoint.servername ?? target.servername ?? original.hostname });
             try {
               await engine.ping(attempt.signal, attempt.remainingMs());
               return { connection: engine, transport: transport.name };
             } catch (error) {
-              await engine.close();
+              try {
+                await engine.close();
+              } catch {}
               throw error;
             }
           },
@@ -134,6 +177,7 @@ class OpenSearchClient {
           retryReason: openSearchRetryReason
         });
       } catch (error) {
+        this.lifecycle.onDiagnostic?.(`OpenSearch connect failed ${describeOpenSearchError(error)}`);
         this.signal.throwIfAborted();
         if (error instanceof ToolboxError && error.kind === "timeout")
           throw error;
@@ -193,4 +237,4 @@ async function openOpenSearch(source, lifecycle = {}) {
   return client;
 }
 
-export { isOpenSearchReadApi, OpenSearchEngine, OpenSearchClient, openOpenSearch };
+export { describeOpenSearchError, isOpenSearchReadApi, OpenSearchEngine, OpenSearchClient, openOpenSearch };

package/dist/{chunk-j46x7j7c.js → chunk-xgnz10sr.js}

@@ -53,11 +53,13 @@ function findPodsForService(services, pods, serviceName, namespace) {
     return [];
   return pods.filter((pod) => pod.namespace === namespace && pod.phase === "Running" && selector.every(([name, value]) => pod.labels[name] === value)).sort((left, right) => left.name.localeCompare(right.name));
 }
-async function listServiceNetwork(executor, namespace) {
+async function listServiceNetwork(executor, namespace, signal) {
+  signal?.throwIfAborted();
   const [serviceResult, podResult] = await Promise.all([
-    executor.run(["get", "services", "-o", "json"], { timeoutMs: 20000 }),
-    executor.run(["get", "pods", "-o", "json"], { timeoutMs: 20000 })
+    executor.run(["get", "services", "-o", "json"], { timeoutMs: 20000, signal }),
+    executor.run(["get", "pods", "-o", "json"], { timeoutMs: 20000, signal })
   ]);
+  signal?.throwIfAborted();
   if (!serviceResult.ok) {
     throw new Error(`读取 Service 失败：${serviceResult.stderr.trim() || `exit=${serviceResult.exitCode}`}`);
   }

package/dist/kubernetes/client.js

@@ -1,9 +1,9 @@
 import {
   KubernetesClient
-} from "../chunk-g2bac2jd.js";
+} from "../chunk-m391jmpw.js";
 import"../chunk-ae84rzq5.js";
-import"../chunk-2171tajs.js";
-import"../chunk-j46x7j7c.js";
+import"../chunk-1ts7pswj.js";
+import"../chunk-xgnz10sr.js";
 import"../chunk-6fnhzhdb.js";
 import"../chunk-x0yhfg29.js";
 import"../chunk-dpcge1xt.js";
@@ -11,9 +11,9 @@ import"../chunk-r3rnsvwv.js";
 import"../chunk-a9htb6cr.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-v3hxvnrc.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 export {
   KubernetesClient
 };

package/dist/kubernetes/environment.js

@@ -1,9 +1,9 @@
 import {
   KubernetesClient
-} from "../chunk-g2bac2jd.js";
+} from "../chunk-m391jmpw.js";
 import"../chunk-ae84rzq5.js";
-import"../chunk-2171tajs.js";
-import"../chunk-j46x7j7c.js";
+import"../chunk-1ts7pswj.js";
+import"../chunk-xgnz10sr.js";
 import"../chunk-6fnhzhdb.js";
 import"../chunk-x0yhfg29.js";
 import"../chunk-dpcge1xt.js";
@@ -13,9 +13,9 @@ import {
 } from "../chunk-a9htb6cr.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-v3hxvnrc.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 
 // src/kubernetes/environment.ts
 class KubernetesEnvironment {

package/dist/kubernetes/executor.js

@@ -3,8 +3,8 @@ import {
   buildExecArgs,
   buildKubectlArgs,
   runArgv
-} from "../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+} from "../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 export {
   runArgv,
   buildKubectlArgs,

package/dist/kubernetes/pod-log.js

@@ -1,7 +1,7 @@
 import {
   findPodsForService,
   parseServices
-} from "../chunk-j46x7j7c.js";
+} from "../chunk-xgnz10sr.js";
 import {
   parsePods
 } from "../chunk-6fnhzhdb.js";

package/dist/kubernetes/port-forward.d.ts

@@ -17,6 +17,7 @@ export interface PortForwardResult {
 }
 export type StartPortForward = typeof startPortForward;
 /**
+ * @spec Caller cancellation stops both startup and an active forward, preserving the original abort reason.
  * 起 `kubectl port-forward svc/<service> 0:<remotePort>` 并等待就绪。
  * 本地端口让 kubectl 自选（0:），从 stdout 的 "Forwarding from 127.0.0.1:<port>" 解析，
  * 避免固定端口在运维机上撞占用。调用方负责在采集结束后 stop()。
@@ -26,6 +27,8 @@ export declare function startPortForward(opts: KubectlOptions & {
     target?: PortForwardTarget;
     remotePort: number;
     timeoutMs?: number;
+    signal?: AbortSignal;
+    onDiagnostic?: (line: string) => void;
 }): Promise<PortForwardResult>;
 /** 同一次诊断可能按拓扑建立多个 forward；scope 保证异常路径也能一次性回收。 */
 export declare class PortForwardScope {
@@ -37,6 +40,8 @@ export declare class PortForwardScope {
         target: PortForwardTarget;
         remotePort: number;
         timeoutMs?: number;
+        signal?: AbortSignal;
+        onDiagnostic?: (line: string) => void;
     }): Promise<PortForwardResult>;
     stop(): void;
 }

package/dist/kubernetes/port-forward.js

@@ -1,9 +1,9 @@
 import {
   PortForwardScope,
   startPortForward
-} from "../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+} from "../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 export {
   startPortForward,
   PortForwardScope

package/dist/kubernetes/service-port-forward.d.ts

@@ -20,6 +20,8 @@ export declare class ServicePortForwarder {
     private constructor();
     static create(executor: Executor, opts: KubectlOptions & {
         namespace: string;
+        signal?: AbortSignal;
+        onDiagnostic?: (line: string) => void;
     }, starter?: StartPortForward): Promise<ServicePortForwarder>;
     get activeForwards(): readonly import("./port-forward").PortForward[];
     forward(endpoint: KubernetesEndpoint): Promise<ForwardedEndpoint>;

package/dist/kubernetes/service-port-forward.js

@@ -1,11 +1,11 @@
 import {
   ServicePortForwarder
-} from "../chunk-2171tajs.js";
-import"../chunk-j46x7j7c.js";
+} from "../chunk-1ts7pswj.js";
+import"../chunk-xgnz10sr.js";
 import"../chunk-6fnhzhdb.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 export {
   ServicePortForwarder
 };

package/dist/kubernetes/service.d.ts

@@ -25,7 +25,7 @@ export declare function findService(services: readonly KubernetesService[], endp
 export declare function findServicesForPod(services: readonly KubernetesService[], pod: KubernetesPod): KubernetesService[];
 /** Service → Pod 由 Kubernetes selector 决定，不让上层用 Pod 名称前缀猜测。 */
 export declare function findPodsForService(services: readonly KubernetesService[], pods: readonly KubernetesPod[], serviceName: string, namespace: string): KubernetesPod[];
-export declare function listServiceNetwork(executor: Executor, namespace: string): Promise<{
+export declare function listServiceNetwork(executor: Executor, namespace: string, signal?: AbortSignal): Promise<{
     services: KubernetesService[];
     pods: KubernetesPod[];
 }>;

package/dist/kubernetes/service.js

@@ -5,7 +5,7 @@ import {
   listServiceNetwork,
   parseServices,
   serviceIdentity
-} from "../chunk-j46x7j7c.js";
+} from "../chunk-xgnz10sr.js";
 import"../chunk-6fnhzhdb.js";
 export {
   serviceIdentity,

package/dist/mysql/client.js

@@ -10,10 +10,10 @@ import"../chunk-gm4swndx.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   openMysql,

package/dist/mysql/index.js

@@ -22,10 +22,10 @@ import"../chunk-gm4swndx.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   withReadScope,

package/dist/opensearch/client.d.ts

@@ -7,6 +7,8 @@ export interface OpenSearchAuth {
 }
 export interface OpenSearchOptions {
     node: string;
+    /** Bounded operational facts; never protocol bodies or credentials. */
+    onDiagnostic?: (line: string) => void;
     auth: OpenSearchAuth;
     requestTimeoutMs?: number;
     /** Per-route mapping and probe budget; query deadlines remain independent. */
@@ -41,6 +43,11 @@ export interface OpenSearchClientApi {
     };
     close(): Promise<void>;
 }
+/** Safe error-chain facts for logs; driver messages/meta can contain credentials and response bodies. */
+export declare function describeOpenSearchError(error: unknown): string;
+export interface OpenSearchLifecycle extends ClientLifecycle {
+    onDiagnostic?: (line: string) => void;
+}
 /** OpenSearch-specific read APIs stay outside the engine-neutral SearchEngine contract. */
 export interface OpenSearchReadApi extends SearchEngine {
     request(path: string, query?: SearchQuery): Promise<unknown>;
@@ -48,11 +55,13 @@ export interface OpenSearchReadApi extends SearchEngine {
 export declare function isOpenSearchReadApi(search: SearchEngine): search is OpenSearchReadApi;
 /** Official OpenSearch client behind the engine-neutral SearchEngine contract. */
 export declare class OpenSearchEngine implements OpenSearchReadApi {
+    private readonly options;
     private readonly client;
     constructor(options: OpenSearchOptions, client?: OpenSearchClientApi);
     count(index: string, query: SearchQuery): Promise<number>;
     search(index: string, body: SearchQuery): Promise<SearchResult>;
     request(path: string, query?: SearchQuery): Promise<unknown>;
+    /** @spec Probe deadlines abort the underlying request even when the driver stalls. */
     ping(signal?: AbortSignal, timeoutMs?: number): Promise<unknown>;
     close(): Promise<void>;
 }
@@ -66,7 +75,7 @@ export declare class OpenSearchClient implements ManagedClient, OpenSearchReadAp
     private readonly source;
     private readonly lifecycle;
     readonly signal: AbortSignal;
-    constructor(source: ConnectionSource<OpenSearchOptions>, lifecycle?: ClientLifecycle);
+    constructor(source: ConnectionSource<OpenSearchOptions>, lifecycle?: OpenSearchLifecycle);
     initialize(): Promise<void>;
     count(index: string, query: SearchQuery): Promise<number>;
     search(index: string, body: SearchQuery): Promise<SearchResult>;
@@ -75,4 +84,4 @@ export declare class OpenSearchClient implements ManagedClient, OpenSearchReadAp
     close(): Promise<void>;
     dispose(): Promise<void>;
 }
-export declare function openOpenSearch(source: ConnectionSource<OpenSearchOptions>, lifecycle?: ClientLifecycle): Promise<OpenSearchClient>;
+export declare function openOpenSearch(source: ConnectionSource<OpenSearchOptions>, lifecycle?: OpenSearchLifecycle): Promise<OpenSearchClient>;

package/dist/opensearch/client.js

@@ -1,20 +1,22 @@
 import {
   OpenSearchClient,
   OpenSearchEngine,
+  describeOpenSearchError,
   isOpenSearchReadApi,
   openOpenSearch
-} from "../chunk-sbt20n84.js";
+} from "../chunk-vymm4g9h.js";
 import"../chunk-gm4swndx.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   openOpenSearch,
   isOpenSearchReadApi,
+  describeOpenSearchError,
   OpenSearchEngine,
   OpenSearchClient
 };

package/dist/opensearch/index.js

@@ -8,22 +8,24 @@ import"../chunk-djk4kmxb.js";
 import {
   OpenSearchClient,
   OpenSearchEngine,
+  describeOpenSearchError,
   isOpenSearchReadApi,
   openOpenSearch
-} from "../chunk-sbt20n84.js";
+} from "../chunk-vymm4g9h.js";
 import"../chunk-gm4swndx.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   searchAfterPages,
   parseOpenSearchEndpoint,
   openOpenSearch,
   isOpenSearchReadApi,
+  describeOpenSearchError,
   OpenSearchEngine,
   OpenSearchClient
 };

package/dist/process/index.d.ts

@@ -2,7 +2,7 @@ export interface RuntimeProcess {
     stdout: ReadableStream<Uint8Array>;
     stderr: ReadableStream<Uint8Array>;
     exited: Promise<number>;
-    kill(): void;
+    kill(signal?: NodeJS.Signals): void;
 }
 export interface SpawnProcessOptions {
     stdin?: string | Uint8Array | ReadableStream<Uint8Array>;

package/dist/process/index.js

@@ -1,7 +1,7 @@
 import {
   sleep,
   spawnProcess
-} from "../chunk-mn6dwsvh.js";
+} from "../chunk-9shz0bw1.js";
 export {
   spawnProcess,
   sleep

package/dist/redis/client.js

@@ -9,10 +9,10 @@ import"../chunk-gm4swndx.js";
 import"../chunk-5tbzf9wd.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   parseRedisInfo,

package/dist/redis/index.js

@@ -15,10 +15,10 @@ import {
 } from "../chunk-5tbzf9wd.js";
 import"../chunk-rkt41za2.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   redisGroupedSampleSizes,

package/dist/s3/datasource.js

@@ -7,10 +7,10 @@ import"../chunk-zp1s833x.js";
 import"../chunk-v3hxvnrc.js";
 import"../chunk-x4ntb898.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   S3DataSource

package/dist/s3/index.js

@@ -9,10 +9,10 @@ import {
 import"../chunk-v3hxvnrc.js";
 import"../chunk-x4ntb898.js";
 import"../chunk-h8fwx0k7.js";
-import"../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+import"../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   S3DataSource,

package/dist/transport/index.js

@@ -6,10 +6,10 @@ import {
 } from "../chunk-h8fwx0k7.js";
 import {
   PodRelayTransport
-} from "../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+} from "../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   isConnectionNetworkError,

package/dist/transport/pod-relay.js

@@ -1,9 +1,9 @@
 import {
   PodRelayTransport
-} from "../chunk-wv4jwhvj.js";
-import"../chunk-631vce5z.js";
-import"../chunk-hmah9t8e.js";
-import"../chunk-mn6dwsvh.js";
+} from "../chunk-fqrknvr8.js";
+import"../chunk-nftzckdy.js";
+import"../chunk-rq5fc007.js";
+import"../chunk-9shz0bw1.js";
 import"../chunk-ssj93brx.js";
 export {
   PodRelayTransport

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-toolbox",
-  "version": "0.4.5",
+  "version": "0.4.8",
   "description": "Shared infrastructure clients, transports and bounded data capture",
   "type": "module",
   "scripts": {
@@ -116,9 +116,6 @@
     "@types/node": "^22",
     "@types/ws": "^8.18.1"
   },
-  "overrides": {
-    "@compforge/harness-common": "file:../common"
-  },
   "publishConfig": {
     "access": "public"
   },