@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.1

package/dist/swappable-python-bridge.js

@@ -0,0 +1,246 @@
+/**
+ * A {@link PythonBridge} that delegates every call to a current target bridge
+ * and re-emits the target's events. Swapping the target is transparent to
+ * holders of the reference: callers keep one stable handle whose behavior
+ * follows the active worker.
+ *
+ * `swap()` only re-points event forwarding — it never connects or closes a
+ * bridge. The owner of the lifecycle (the server) connects a worker bridge
+ * before swapping it in and closes it after swapping away.
+ */
+import { EventEmitter } from "node:events";
+/**
+ * Events re-emitted from the active target. The set is the union of what the
+ * bridges emit (stderr, exit, progress, activity, reconnected) and what
+ * consumers listen for (error, stdout). `"error"` is special-cased below.
+ */
+const FORWARDED_EVENTS = [
+    "stderr",
+    "stdout",
+    "error",
+    "exit",
+    "activity",
+    "progress",
+    "reconnected"
+];
+export class SwappableBridge extends EventEmitter {
+    _target;
+    // Bound forwarders kept so listeners can be removed on swap.
+    _forwarders = new Map();
+    constructor(initial) {
+        super();
+        this._target = initial;
+        for (const event of FORWARDED_EVENTS) {
+            this._forwarders.set(event, (...args) => {
+                if (event === "error") {
+                    // Re-emitting "error" with no listener throws on an EventEmitter;
+                    // swallow it instead (a no-listener error must not crash the server).
+                    if (this.listenerCount("error") > 0) {
+                        this.emit("error", ...args);
+                    }
+                    return;
+                }
+                this.emit(event, ...args);
+            });
+        }
+        this._subscribe(initial);
+    }
+    /** The currently-delegated target (the server compares this to the local bridge). */
+    get target() {
+        return this._target;
+    }
+    /** Swap the delegate. Re-points event forwarding; does NOT close either bridge. */
+    swap(next) {
+        if (next === this._target)
+            return;
+        this._unsubscribe(this._target);
+        this._target = next;
+        this._subscribe(next);
+    }
+    _subscribe(target) {
+        for (const [event, forwarder] of this._forwarders) {
+            target.on(event, forwarder);
+        }
+    }
+    _unsubscribe(target) {
+        for (const [event, forwarder] of this._forwarders) {
+            target.off(event, forwarder);
+        }
+    }
+    // ── Delegated PythonBridge surface ─────────────────────────────────────
+    connect() {
+        return this._target.connect();
+    }
+    ensureConnected() {
+        return this._target.ensureConnected();
+    }
+    execute(nodeType, fields, secrets, blobs, onProgress, identity) {
+        return this._target.execute(nodeType, fields, secrets, blobs, onProgress, identity);
+    }
+    executeStream(nodeType, fields, secrets, blobs, onProgress, identity) {
+        return this._target.executeStream(nodeType, fields, secrets, blobs, onProgress, identity);
+    }
+    cancel(requestId) {
+        this._target.cancel(requestId);
+    }
+    getNodeMetadata() {
+        return this._target.getNodeMetadata();
+    }
+    getLoadErrors() {
+        return this._target.getLoadErrors();
+    }
+    getWorkerStatus() {
+        return this._target.getWorkerStatus();
+    }
+    hasNodeType(nodeType) {
+        return this._target.hasNodeType(nodeType);
+    }
+    get isConnected() {
+        return this._target.isConnected;
+    }
+    isAvailable() {
+        return this._target.isAvailable();
+    }
+    listProviders() {
+        return this._target.listProviders();
+    }
+    getProviderModels(providerId, modelType, secrets) {
+        return this._target.getProviderModels(providerId, modelType, secrets);
+    }
+    providerGenerate(providerId, messages, model, options) {
+        return this._target.providerGenerate(providerId, messages, model, options);
+    }
+    providerStream(providerId, messages, model, options) {
+        return this._target.providerStream(providerId, messages, model, options);
+    }
+    providerTTS(providerId, text, model, options) {
+        return this._target.providerTTS(providerId, text, model, options);
+    }
+    providerTextToImage(providerId, params, secrets, signal) {
+        return this._target.providerTextToImage(providerId, params, secrets, signal);
+    }
+    providerImageToImage(providerId, image, params, secrets, signal) {
+        return this._target.providerImageToImage(providerId, image, params, secrets, signal);
+    }
+    providerTextToVideo(providerId, params, secrets, signal) {
+        return this._target.providerTextToVideo(providerId, params, secrets, signal);
+    }
+    providerImageToVideo(providerId, image, params, secrets, signal) {
+        return this._target.providerImageToVideo(providerId, image, params, secrets, signal);
+    }
+    providerReferenceToVideo(providerId, inputs, params, secrets, signal) {
+        return this._target.providerReferenceToVideo(providerId, inputs, params, secrets, signal);
+    }
+    providerTextToAudio(providerId, params, secrets) {
+        return this._target.providerTextToAudio(providerId, params, secrets);
+    }
+    providerTTSEncoded(providerId, params, secrets) {
+        return this._target.providerTTSEncoded(providerId, params, secrets);
+    }
+    providerASR(providerId, audio, model, options) {
+        return this._target.providerASR(providerId, audio, model, options);
+    }
+    providerEmbedding(providerId, text, model, dimensions) {
+        return this._target.providerEmbedding(providerId, text, model, dimensions);
+    }
+    listCachedModels() {
+        return this._target.listCachedModels();
+    }
+    downloadModel(req, onProgress, requestId) {
+        return this._target.downloadModel(req, onProgress, requestId);
+    }
+    prepareModel(req, onProgress, requestId) {
+        return this._target.prepareModel(req, onProgress, requestId);
+    }
+    supportsModelPreparation(backend) {
+        return this._target.supportsModelPreparation(backend);
+    }
+    cancelModelDownload(requestId) {
+        this._target.cancelModelDownload(requestId);
+    }
+    deleteCachedModel(repoId) {
+        return this._target.deleteCachedModel(repoId);
+    }
+    supportsModelManagement() {
+        return this._target.supportsModelManagement();
+    }
+    evictModels(req) {
+        return this._target.evictModels(req);
+    }
+    supportsJobLifecycle() {
+        return this._target.supportsJobLifecycle();
+    }
+    jobStart(job) {
+        return this._target.jobStart(job);
+    }
+    jobEnd(job) {
+        return this._target.jobEnd(job);
+    }
+    supportsComfy() {
+        return this._target.supportsComfy();
+    }
+    getComfyStatus() {
+        return this._target.getComfyStatus();
+    }
+    comfyExecute(workflow, options, onEvent, requestId) {
+        return this._target.comfyExecute(workflow, options, onEvent, requestId);
+    }
+    cancelComfyExecute(requestId) {
+        this._target.cancelComfyExecute(requestId);
+    }
+    supportsBlender() {
+        return this._target.supportsBlender();
+    }
+    getBlenderStatus() {
+        return this._target.getBlenderStatus();
+    }
+    blenderExecute(job, inputs, options, onEvent, requestId) {
+        return this._target.blenderExecute(job, inputs, options, onEvent, requestId);
+    }
+    cancelBlenderExecute(requestId) {
+        this._target.cancelBlenderExecute(requestId);
+    }
+    comfyQueue() {
+        return this._target.comfyQueue();
+    }
+    comfyInterrupt() {
+        return this._target.comfyInterrupt();
+    }
+    comfyCancelPrompt(promptId) {
+        return this._target.comfyCancelPrompt(promptId);
+    }
+    comfyUpload(filename, bytes, options) {
+        return this._target.comfyUpload(filename, bytes, options);
+    }
+    comfyView(filename, options) {
+        return this._target.comfyView(filename, options);
+    }
+    comfyObjectInfo() {
+        return this._target.comfyObjectInfo();
+    }
+    comfySystemStats() {
+        return this._target.comfySystemStats();
+    }
+    comfyStatus() {
+        return this._target.comfyStatus();
+    }
+    comfyFree(options) {
+        return this._target.comfyFree(options);
+    }
+    comfyModelsList(folder) {
+        return this._target.comfyModelsList(folder);
+    }
+    comfyModelsDownload(req, onProgress, requestId) {
+        return this._target.comfyModelsDownload(req, onProgress, requestId);
+    }
+    comfyModelsDelete(folder, filename) {
+        return this._target.comfyModelsDelete(folder, filename);
+    }
+    getRecentStderrSummary(limit) {
+        return this._target.getRecentStderrSummary(limit);
+    }
+    close() {
+        this._target.close();
+    }
+}
+//# sourceMappingURL=swappable-python-bridge.js.map

package/dist/swappable-python-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swappable-python-bridge.js","sourceRoot":"","sources":["../src/swappable-python-bridge.ts"],"names":[],"mappings":"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"}

package/dist/telemetry.d.ts

@@ -53,6 +53,13 @@ export interface TelemetryOptions {
 export declare function initTelemetry(options?: TelemetryOptions): Promise<boolean>;
 /** Returns the active tracer, or null if telemetry is not initialized. */
 export declare function getTracer(): Tracer | null;
+/**
+ * Flush and shut down the OpenTelemetry SDK. Must be awaited before a
+ * short-lived process exits — the OTLP/Traceloop sink uses a BatchSpanProcessor
+ * that only ships buffered spans on a timer or an explicit shutdown, so without
+ * this a CLI that finishes before the batch delay delivers zero traces.
+ */
+export declare function shutdownTelemetry(): Promise<void>;
 /**
  * Reset the telemetry singleton. Test-only — production code should call
  * `initTelemetry()` exactly once at startup.

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAwGlB;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQzD,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAyGlB;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C"}

package/dist/telemetry.js

@@ -26,6 +26,7 @@ import { createLogger } from "@nodetool-ai/config";
 const log = createLogger("nodetool.runtime.telemetry");
 let _tracer = null;
 let _initialized = false;
+let _sdk = null;
 /**
  * Initialize OpenTelemetry instrumentation.
  *
@@ -104,6 +105,7 @@ export async function initTelemetry(options = {}) {
     // is safe across versions and avoids racing the first spans on any
     // version that does init asynchronously.
     await sdk.start();
+    _sdk = sdk;
     _tracer = otelApi.trace.getTracer("nodetool", "0.1.0");
     _initialized = true;
     if (!options.silent) {
@@ -117,6 +119,26 @@ export async function initTelemetry(options = {}) {
 export function getTracer() {
     return _tracer;
 }
+/**
+ * Flush and shut down the OpenTelemetry SDK. Must be awaited before a
+ * short-lived process exits — the OTLP/Traceloop sink uses a BatchSpanProcessor
+ * that only ships buffered spans on a timer or an explicit shutdown, so without
+ * this a CLI that finishes before the batch delay delivers zero traces.
+ */
+export async function shutdownTelemetry() {
+    const sdk = _sdk;
+    _sdk = null;
+    _tracer = null;
+    _initialized = false;
+    if (sdk) {
+        try {
+            await sdk.shutdown();
+        }
+        catch (err) {
+            log.warn("Telemetry shutdown failed", err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+}
 /**
  * Reset the telemetry singleton. Test-only — production code should call
  * `initTelemetry()` exactly once at startup.
@@ -124,5 +146,6 @@ export function getTracer() {
 export function _resetTelemetryForTest() {
     _tracer = null;
     _initialized = false;
+    _sdk = null;
 }
 //# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/testing.d.ts

@@ -0,0 +1,81 @@
+import { ProcessingContext } from "./context.js";
+import type { BaseProvider } from "./providers/base-provider.js";
+export interface FakeContextOptions {
+    /**
+     * Override the fake provider returned for any providerId. Useful when a
+     * test wants to assert call shape (e.g. last messages) or inject a
+     * scripted-response provider for one specific id.
+     */
+    providers?: Record<string, BaseProvider>;
+    /**
+     * Default provider used when `providers[providerId]` is not set. When
+     * omitted, a fresh `FakeProvider` is created on first request and cached.
+     */
+    defaultProvider?: BaseProvider;
+    /**
+     * Override `fetch`. Defaults to a stub that returns an empty `200 OK`
+     * `text/plain` response for any URL so HTTP nodes don't hang or hit
+     * the network.
+     */
+    fetchFn?: (input: string, init?: RequestInit) => Promise<Response>;
+    /**
+     * Override secret resolution. By default the fake context returns
+     * empty string for every secret — provider calls go through the
+     * fake-provider resolver and never consult secrets, while nodes that
+     * use real API keys (e.g. SerpAPI-backed search) fail fast with
+     * "<KEY> is required" rather than reaching the real network with a
+     * junk credential.
+     *
+     * Return `null` from this callback to fall back to the empty default;
+     * return any string to override.
+     */
+    secretResolver?: (key: string) => string | null;
+    /**
+     * Variables exposed to nodes via `context.getVariable()`. Defaults to
+     * an empty object.
+     */
+    variables?: Record<string, unknown>;
+    /**
+     * Workspace directory. When omitted, a fresh temp dir is created under
+     * `os.tmpdir()` for the duration of the context.
+     */
+    workspaceDir?: string;
+    /**
+     * Job id reported to message consumers. Defaults to "fake-job".
+     */
+    jobId?: string;
+    /** Whether workflow outputs should be persisted as assets. Defaults to true. */
+    persistOutputAssets?: boolean;
+}
+export interface FakeContextHandle {
+    context: ProcessingContext;
+    /** Temp workspace directory created for this context (always present). */
+    workspaceDir: string;
+    /** All providers handed out by `getProvider`, keyed by providerId. */
+    providers: Map<string, BaseProvider>;
+    /**
+     * Removes the temp workspace dir. Safe to call multiple times; callers
+     * should run it in `afterEach` or `finally`.
+     */
+    cleanup(): void;
+}
+/**
+ * Build a ProcessingContext wired to in-memory storage, an in-memory cache,
+ * a fake-provider resolver, and a stubbed `fetch`. The returned handle owns
+ * the temp workspace dir; call `cleanup()` when done.
+ */
+export declare function createFakeContext(options?: FakeContextOptions): FakeContextHandle;
+/**
+ * Replace `globalThis.fetch` with a stub that returns a `200 OK` empty
+ * response. Returns a restore function that puts the original `fetch`
+ * back. Useful for tests that touch nodes which bypass
+ * {@link ProcessingContext}'s fetch indirection (e.g. SerpAPI-backed
+ * search nodes that call `fetch` directly) and would otherwise reach
+ * the real network with stub credentials.
+ *
+ * Pass a `responder` to return per-URL responses instead of the empty
+ * default — handy when a test wants to assert behaviour on a specific
+ * endpoint.
+ */
+export declare function stubGlobalFetch(responder?: (url: string, init?: RequestInit) => Response | Promise<Response>): () => void;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,iBAAiB,EAAe,MAAM,cAAc,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC;;;OAGG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAoBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA2DnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAC5E,MAAM,IAAI,CAyBZ"}

package/dist/testing.js

@@ -0,0 +1,130 @@
+/**
+ * Test-only helpers that wire a {@link ProcessingContext} to in-memory fakes
+ * for every external dependency a workflow might touch.
+ *
+ * The goal is to let workflow examples *execute* end-to-end inside a unit
+ * test without making any provider call, opening any socket, or touching
+ * the user's file system. Imports are kept lean so the module stays cheap
+ * to load from any package's tests.
+ */
+import { getNodeBuiltinSync } from "@nodetool-ai/config";
+const os = getNodeBuiltinSync("node:os");
+const path = getNodeBuiltinSync("node:path");
+const fs = getNodeBuiltinSync("node:fs");
+import { InMemoryStorageAdapter } from "@nodetool-ai/storage";
+import { ProcessingContext, MemoryCache } from "./context.js";
+import { FakeProvider } from "./providers/fake-provider.js";
+import { isString } from "@nodetool-ai/protocol";
+/**
+ * Default `fetch` stub. Returns an empty `200 OK` `text/plain` response
+ * for every URL. Real workflows expecting JSON will get `{}` back.
+ */
+function defaultFakeFetch() {
+    return async (input, _init) => {
+        const url = isString(input) ? input : String(input);
+        const body = url.endsWith(".json") || url.includes("/api/") ? "{}" : "";
+        return new Response(body, {
+            status: 200,
+            headers: { "content-type": "text/plain" }
+        });
+    };
+}
+/**
+ * Build a ProcessingContext wired to in-memory storage, an in-memory cache,
+ * a fake-provider resolver, and a stubbed `fetch`. The returned handle owns
+ * the temp workspace dir; call `cleanup()` when done.
+ */
+export function createFakeContext(options = {}) {
+    const ownsWorkspaceDir = options.workspaceDir == null;
+    const workspaceDir = options.workspaceDir ??
+        fs.mkdtempSync(path.join(os.tmpdir(), "nodetool-fake-ws-"));
+    const providers = new Map();
+    for (const [id, prov] of Object.entries(options.providers ?? {})) {
+        providers.set(id, prov);
+    }
+    const context = new ProcessingContext({
+        jobId: options.jobId ?? "fake-job",
+        userId: "fake-user",
+        workspaceDir,
+        cache: new MemoryCache(),
+        storage: new InMemoryStorageAdapter(),
+        workspaceStorage: new InMemoryStorageAdapter(),
+        variables: options.variables ?? {},
+        persistOutputAssets: options.persistOutputAssets ?? true,
+        fetchFn: options.fetchFn ?? defaultFakeFetch(),
+        secretResolver: (key) => {
+            if (options.secretResolver) {
+                const v = options.secretResolver(key);
+                if (v !== null)
+                    return v;
+            }
+            // Default to empty so nodes that bypass the provider abstraction
+            // (e.g. SerpAPI search nodes calling `fetch` directly) error out on
+            // a missing key instead of hitting the real network with a junk
+            // credential. Providers don't consult this resolver because the
+            // provider-resolver short-circuits the secret lookup.
+            return "";
+        }
+    });
+    context.setProviderResolver((providerId) => {
+        const existing = providers.get(providerId);
+        if (existing)
+            return existing;
+        const fresh = options.defaultProvider ?? new FakeProvider();
+        providers.set(providerId, fresh);
+        return fresh;
+    });
+    return {
+        context,
+        workspaceDir,
+        providers,
+        cleanup: () => {
+            // Only remove the workspace dir if we created it. When the caller
+            // supplied their own path, leave the directory alone — a stray
+            // `rm -rf` on a caller-owned path would be dangerous.
+            if (!ownsWorkspaceDir)
+                return;
+            try {
+                fs.rmSync(workspaceDir, { recursive: true, force: true });
+            }
+            catch {
+                // Best effort — tests that already cleaned up shouldn't fail here.
+            }
+        }
+    };
+}
+/**
+ * Replace `globalThis.fetch` with a stub that returns a `200 OK` empty
+ * response. Returns a restore function that puts the original `fetch`
+ * back. Useful for tests that touch nodes which bypass
+ * {@link ProcessingContext}'s fetch indirection (e.g. SerpAPI-backed
+ * search nodes that call `fetch` directly) and would otherwise reach
+ * the real network with stub credentials.
+ *
+ * Pass a `responder` to return per-URL responses instead of the empty
+ * default — handy when a test wants to assert behaviour on a specific
+ * endpoint.
+ */
+export function stubGlobalFetch(responder) {
+    const original = globalThis.fetch;
+    const stub = async (input, init) => {
+        const url = isString(input)
+            ? input
+            : input instanceof URL
+                ? input.toString()
+                : input.url;
+        if (responder) {
+            return responder(url, init);
+        }
+        const body = url.endsWith(".json") || url.includes("/api/") ? "{}" : "";
+        return new Response(body, {
+            status: 200,
+            headers: { "content-type": "text/plain" }
+        });
+    };
+    globalThis.fetch = stub;
+    return () => {
+        globalThis.fetch = original;
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"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"}

package/dist/token-counter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Accurate token counting via js-tiktoken.
+ *
+ * All token counting in the codebase routes through this module so estimates
+ * match the BPE tokenization real models use instead of char- or word-based
+ * approximations. Uses the `cl100k_base` encoding (GPT-3.5/4 family), a good
+ * general-purpose proxy across providers for budgeting, packing and eviction.
+ *
+ * The encoder is built once and cached — `getEncoding` bundles the BPE ranks,
+ * so there is no I/O after the first call.
+ */
+/**
+ * Count BPE tokens in a string. Returns 0 for empty/nullish input.
+ */
+export declare function countTokens(text: string | null | undefined): number;
+/**
+ * Truncate text to at most `maxTokens` BPE tokens, decoding the kept prefix
+ * back to a string. Returns "" when `maxTokens <= 0`.
+ *
+ * Encodes piece-by-piece (same splitting as {@link countTokens}) and stops once
+ * the budget is reached, so it never feeds a huge boundary-free run to `encode`
+ * in one shot — the input is bounded the same way the count is.
+ *
+ * A token boundary can fall in the middle of a multi-byte UTF-8 character, so
+ * decoding the kept prefix can leave a trailing U+FFFD replacement character or
+ * a lone UTF-16 surrogate. Any such trailing partial character is stripped so
+ * the result is always well-formed text.
+ */
+export declare function truncateToTokens(text: string, maxTokens: number): string;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../src/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4EH;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAkBxE"}