@pi-harness/pi-harness 0.1.14 → 0.1.15

package/packages/core/src/bounded-file.ts

@@ -1,41 +0,0 @@
-import { constants } from "node:fs";
-import { open } from "node:fs/promises";
-
-export class BoundedFileSizeError extends Error {}
-export class BoundedFileTypeError extends Error {}
-
-export async function readBoundedFile(path: string, maxBytes: number, label: string): Promise<Buffer> {
-  if (!Number.isSafeInteger(maxBytes) || maxBytes < 0) throw new Error("Bounded file size must be a non-negative safe integer");
-  let handle: Awaited<ReturnType<typeof open>> | undefined;
-  try {
-    handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
-    const metadata = await handle.stat();
-    if (!metadata.isFile()) throw new BoundedFileTypeError(`${label} must be a regular file`);
-    if (metadata.size > maxBytes) throw new BoundedFileSizeError(`${label} exceeds the ${maxBytes}-byte limit`);
-    const chunks: Buffer[] = [];
-    let total = 0;
-    while (total <= maxBytes) {
-      const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, maxBytes + 1 - total));
-      const { bytesRead } = await handle.read(buffer, 0, buffer.length, null);
-      if (bytesRead === 0) break;
-      chunks.push(buffer.subarray(0, bytesRead));
-      total += bytesRead;
-    }
-    if (total > maxBytes) throw new BoundedFileSizeError(`${label} exceeds the ${maxBytes}-byte limit`);
-    return Buffer.concat(chunks, total);
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === "ELOOP") throw new BoundedFileTypeError(`${label} cannot be a symbolic link`, { cause: error });
-    throw error;
-  } finally {
-    await handle?.close();
-  }
-}
-
-export async function readBoundedTextFile(path: string, maxBytes: number, label: string): Promise<string> {
-  const bytes = await readBoundedFile(path, maxBytes, label);
-  try {
-    return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-  } catch (error) {
-    throw new Error(`${label} must contain valid UTF-8`, { cause: error });
-  }
-}

package/packages/core/src/config.ts

@@ -1,24 +0,0 @@
-import z from "@deepseek-ai/schemastery";
-
-export const EmptyConfig = z.transform(z.any(), (value: unknown) => {
-  if (value === undefined || value === null) return {};
-  if (typeof value !== "object" || Array.isArray(value)) throw new Error("expected an object");
-  let prototype: unknown;
-  let keys: readonly PropertyKey[];
-  try {
-    prototype = Object.getPrototypeOf(value);
-    keys = Reflect.ownKeys(value);
-  } catch (error) {
-    throw new Error("configuration could not be inspected safely", { cause: error });
-  }
-  if (prototype !== Object.prototype && prototype !== null) throw new Error("configuration must be a plain object");
-  if (keys.length > 0) throw new Error(`unknown config keys: ${keys.map((key) => String(key)).join(", ")}`);
-  return {};
-});
-
-export function assertKnownConfigKeys(plugin: string, config: unknown, known: readonly string[]): void {
-  if (config === undefined || config === null || typeof config !== "object") return;
-  const unknown = Object.keys(config).filter((key) => !known.includes(key));
-  if (unknown.length > 0)
-    throw new Error(`Unknown ${plugin} config keys: ${unknown.join(", ")}; supported keys are ${known.length === 0 ? "(none)" : known.join(", ")}`);
-}

package/packages/core/src/context.ts

@@ -1,3 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-
-export type HarnessContext = Context;

package/packages/core/src/cordis-timer.ts

@@ -1,107 +0,0 @@
-import TimerService from "@deepseek-ai/cordis-plugin-timer";
-
-type DisposableFunction<F> = F & { dispose: () => void };
-
-const maximumTimerDelay = 2_147_483_647;
-
-function assertTimerDelay(operation: string, value: unknown, allowZero: boolean): asserts value is number {
-  const minimum = allowZero ? 0 : 1;
-  if (typeof value !== "number" || !Number.isInteger(value) || value < minimum || value > maximumTimerDelay)
-    throw new RangeError(`Timer delay for ${operation} must be an integer from ${minimum} to ${maximumTimerDelay} milliseconds`);
-}
-
-function assertCallback(operation: string, value: unknown): asserts value is (...args: unknown[]) => void {
-  if (typeof value !== "function") throw new TypeError(`Timer callback for ${operation} must be a function`);
-}
-
-function guardedIntervalIterator(iterator: AsyncIterableIterator<void, unknown, void>): AsyncIterableIterator<void, unknown, void> {
-  let nextPending = false;
-  return {
-    next() {
-      if (nextPending) return Promise.reject(new Error("Concurrent timer interval next() calls are not supported"));
-      nextPending = true;
-      return iterator.next().finally(() => {
-        nextPending = false;
-      });
-    },
-    return(value) {
-      return iterator.return?.(value) ?? Promise.resolve({ done: true, value });
-    },
-    throw(reason) {
-      return iterator.throw?.(reason) ?? Promise.reject(reason instanceof Error ? reason : new Error("Timer interval iterator failed", { cause: reason }));
-    },
-    [Symbol.asyncIterator]() {
-      return this;
-    },
-  };
-}
-
-/** Host-hardened adapter for the vendored Cordis timer service. */
-export default class HardenedTimerService extends TimerService {
-  override timeout(callback: () => void, delay: number): () => void;
-  override timeout(delay: number): Promise<void>;
-  override timeout(...args: unknown[]): unknown {
-    if (args.length === 1) {
-      assertTimerDelay("timeout", args[0], true);
-      return super.timeout(args[0]);
-    }
-    if (args.length !== 2) throw new TypeError("Timer timeout requires a delay or a callback and delay");
-    assertCallback("timeout", args[0]);
-    assertTimerDelay("timeout", args[1], true);
-    return super.timeout(args[0], args[1]);
-  }
-
-  override interval(callback: () => void, delay: number): () => void;
-  override interval<R = unknown>(delay: number): AsyncIterableIterator<void, R, void>;
-  override interval(...args: unknown[]): unknown {
-    if (args.length === 1) {
-      assertTimerDelay("interval", args[0], false);
-      return guardedIntervalIterator(super.interval(args[0]));
-    }
-    if (args.length !== 2) throw new TypeError("Timer interval requires a delay or a callback and delay");
-    assertCallback("interval", args[0]);
-    assertTimerDelay("interval", args[1], false);
-    return super.interval(args[0], args[1]);
-  }
-
-  override throttle<F extends (...args: never[]) => void>(callback: F, delay: number, noTrailing?: boolean): DisposableFunction<F> {
-    assertCallback("throttle", callback);
-    assertTimerDelay("throttle", delay, false);
-    if (noTrailing !== undefined && typeof noTrailing !== "boolean") throw new TypeError("Timer throttle noTrailing must be a boolean");
-    let disposed = false;
-    let timer: ReturnType<typeof setTimeout> | undefined;
-    let lastCall = -Infinity;
-    const execute = (args: unknown[]): void => {
-      if (disposed) return;
-      lastCall = Date.now();
-      callback(...(args as never[]));
-    };
-    const dispose = this.ctx.effect(
-      () => () => {
-        disposed = true;
-        clearTimeout(timer);
-        timer = undefined;
-      },
-      "ctx.throttle()",
-    );
-    const wrapper = ((...args: unknown[]) => {
-      if (disposed) return;
-      clearTimeout(timer);
-      timer = undefined;
-      const remaining = delay - Date.now() + lastCall;
-      if (remaining <= 0) execute(args);
-      else if (!noTrailing)
-        timer = setTimeout(() => {
-          timer = undefined;
-          execute(args);
-        }, remaining);
-    }) as unknown as F;
-    return Object.assign(wrapper, { dispose });
-  }
-
-  override debounce<F extends (...args: never[]) => void>(callback: F, delay: number): DisposableFunction<F> {
-    assertCallback("debounce", callback);
-    assertTimerDelay("debounce", delay, false);
-    return super.debounce(callback, delay);
-  }
-}

package/packages/core/src/http.ts

@@ -1,32 +0,0 @@
-import type { AgentSessionServices } from "@earendil-works/pi-coding-agent";
-
-interface HttpDispatcherModule {
-  applyHttpProxySettings(httpProxy: string | undefined): void;
-  configureHttpDispatcher(timeoutMs?: number): void;
-}
-
-// Pi installs an undici EnvHttpProxyAgent so provider calls honour HTTP(S)_PROXY and the
-// settings-level httpProxy. Its package exports map does not expose that module, so it is
-// imported by the file URL derived from the package entry: that keeps one undici instance
-// shared with Pi, which a direct undici dependency of our own would not.
-async function loadHttpDispatcher(): Promise<HttpDispatcherModule> {
-  const entry = import.meta.resolve("@earendil-works/pi-coding-agent");
-  return (await import(new URL("./core/http-dispatcher.js", entry).href)) as HttpDispatcherModule;
-}
-
-/**
- * Route provider traffic through the proxy the environment or Pi's settings configure.
- *
- * @returns undefined on success, or a diagnostic message when Pi's dispatcher module could not be loaded.
- */
-export async function configureHttpProxy(services?: AgentSessionServices): Promise<string | undefined> {
-  let dispatcher: HttpDispatcherModule;
-  try {
-    dispatcher = await loadHttpDispatcher();
-  } catch (cause) {
-    return `Pi HTTP dispatcher is unavailable, so HTTP_PROXY, HTTPS_PROXY and the httpProxy setting are ignored: ${cause instanceof Error ? cause.message : String(cause)}`;
-  }
-  if (services !== undefined) dispatcher.applyHttpProxySettings(services.settingsManager.getGlobalSettings().httpProxy);
-  dispatcher.configureHttpDispatcher(services?.settingsManager.getHttpIdleTimeoutMs());
-  return undefined;
-}

package/packages/core/src/index.ts

@@ -1,8 +0,0 @@
-export * from "./boot.js";
-export * from "./config.js";
-export * from "./http.js";
-export type * from "./context.js";
-export * from "./profile.js";
-export * from "./runtime.js";
-export * from "./services.js";
-export * from "./stdio.js";