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

package/dist/swappable-python-bridge.d.ts.map

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

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":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkC3C;;;;GAIG;AACH,MAAM,gBAAgB,GAAG;IACvB,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,MAAM;IACN,UAAU;IACV,UAAU;IACV,aAAa;CACL,CAAC;AAEX,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACvC,OAAO,CAAe;IAC9B,6DAA6D;IAC5C,WAAW,GAAG,IAAI,GAAG,EAGnC,CAAC;IAEJ,YAAY,OAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;gBACjD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;oBACtB,kEAAkE;oBAClE,sEAAsE;oBACtE,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBACpC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;oBAC9B,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,qFAAqF;IACrF,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAkB;QACrB,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO;QAClC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,MAAoB;QACrC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAoB;QACvC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,0EAA0E;IAE1E,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,CACL,QAAgB,EAChB,MAA+B,EAC/B,OAA+B,EAC/B,KAAwB,EACxB,UAA2C,EAC3C,QAA0B;QAE1B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CACzB,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,MAA+B,EAC/B,OAA+B,EAC/B,KAAwB,EACxB,UAA2C,EAC3C,QAA0B;QAE1B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAC/B,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IAClC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED,iBAAiB,CACf,UAAkB,EAClB,SAAiB,EACjB,OAAgC;QAEhC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,gBAAgB,CACd,UAAkB,EAClB,QAAmC,EACnC,KAAa,EACb,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED,cAAc,CACZ,UAAkB,EAClB,QAAmC,EACnC,KAAa,EACb,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,WAAW,CACT,UAAkB,EAClB,IAAY,EACZ,KAAa,EACb,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,mBAAmB,CACjB,UAAkB,EAClB,MAA+B,EAC/B,OAAgC,EAChC,MAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC;IAED,oBAAoB,CAClB,UAAkB,EAClB,KAAiB,EACjB,MAA+B,EAC/B,OAAgC,EAChC,MAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,CACtC,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,mBAAmB,CACjB,UAAkB,EAClB,MAA+B,EAC/B,OAAgC,EAChC,MAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CACrC,UAAU,EACV,MAAM,EACN,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,oBAAoB,CAClB,UAAkB,EAClB,KAAiB,EACjB,MAA+B,EAC/B,OAAgC,EAChC,MAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,CACtC,UAAU,EACV,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,wBAAwB,CACtB,UAAkB,EAClB,MAA6D,EAC7D,MAA+B,EAC/B,OAAgC,EAChC,MAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAC1C,UAAU,EACV,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAED,mBAAmB,CACjB,UAAkB,EAClB,MAA+B,EAC/B,OAAgC;QAEhC,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,kBAAkB,CAChB,UAAkB,EAClB,MAA+B,EAC/B,OAAgC;QAEhC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,WAAW,CACT,UAAkB,EAClB,KAAiB,EACjB,KAAa,EACb,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,iBAAiB,CACf,UAAkB,EAClB,IAAuB,EACvB,KAAa,EACb,UAAmB;QAEnB,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;IAED,aAAa,CACX,GAAyB,EACzB,UAAiD,EACjD,SAAkB;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED,YAAY,CACV,GAAwB,EACxB,UAAiD,EACjD,SAAkB;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,wBAAwB,CAAC,OAAe;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,mBAAmB,CAAC,SAAiB;QACnC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAChD,CAAC;IAED,WAAW,CAAC,GAAuB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,GAAgB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,GAAgB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;IAED,YAAY,CACV,QAAiC,EACjC,OAA6B,EAC7B,OAAqC,EACrC,SAAkB;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;IAED,cAAc,CACZ,GAAsB,EACtB,MAA8B,EAC9B,OAA+B,EAC/B,OAAuC,EACvC,SAAkB;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAChC,GAAG,EACH,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,CACV,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,SAAiB;QACpC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,WAAW,CACT,QAAgB,EAChB,KAAiB,EACjB,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,CACP,QAAgB,EAChB,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,OAAiC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,eAAe,CAAC,MAAe;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,mBAAmB,CACjB,GAA8B,EAC9B,UAAsD,EACtD,SAAkB;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IAED,iBAAiB,CAAC,MAAc,EAAE,QAAgB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,sBAAsB,CAAC,KAAc;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/telemetry.d.ts

@@ -10,7 +10,11 @@
  *
  *   OpenTelemetry / OTLP:
  *     TRACELOOP_API_KEY            — Traceloop cloud API key
- *     OTEL_EXPORTER_OTLP_ENDPOINT  — Any OTLP-compatible backend
+ *     OTEL_EXPORTER_OTLP_ENDPOINT  — Any OTLP-compatible backend (`/v1/traces`
+ *                                    is appended)
+ *     OTEL_EXPORTER_OTLP_TRACES_ENDPOINT — Full traces URL, used as given;
+ *                                    wins over OTEL_EXPORTER_OTLP_ENDPOINT
+ *     OTEL_EXPORTER_OTLP_HEADERS   — Extra exporter headers (read by the SDK)
  *     OTEL_SERVICE_NAME            — Service name tag (default: "nodetool")
  *     OTEL_TRACES_EXPORTER=console — Print spans to stdout via OTel SDK
  *     TRACELOOP_DISABLE_BATCH=true — Flush spans immediately (dev mode)
@@ -22,7 +26,7 @@
  * All NodeTool sinks emit the same {@link TraceRecord} shape (see
  * trace-exporters.ts) so a downstream agent can ingest either one.
  */
-import type { Tracer } from "@opentelemetry/api";
+import { type Tracer } from "@opentelemetry/api";
 import type { StdoutFormat } from "./trace-exporters.js";
 export interface TelemetryOptions {
     /** Override the service name (defaults to OTEL_SERVICE_NAME or "nodetool"). */
@@ -48,11 +52,20 @@ export interface TelemetryOptions {
  * Initialize OpenTelemetry instrumentation.
  *
  * Idempotent: calling more than once is a no-op (returns the previous result).
- * Returns true if at least one sink is active, false if telemetry was skipped.
+ * The durable processor is always active. External sinks remain optional.
  */
 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>;
+/** Wait until the durable processor has persisted every queued completed record. */
+export declare function flushTelemetry(): 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYzD,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,CAwHlB;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBvD;AAED,oFAAoF;AACpF,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C"}

package/dist/telemetry.js

@@ -10,7 +10,11 @@
  *
  *   OpenTelemetry / OTLP:
  *     TRACELOOP_API_KEY            — Traceloop cloud API key
- *     OTEL_EXPORTER_OTLP_ENDPOINT  — Any OTLP-compatible backend
+ *     OTEL_EXPORTER_OTLP_ENDPOINT  — Any OTLP-compatible backend (`/v1/traces`
+ *                                    is appended)
+ *     OTEL_EXPORTER_OTLP_TRACES_ENDPOINT — Full traces URL, used as given;
+ *                                    wins over OTEL_EXPORTER_OTLP_ENDPOINT
+ *     OTEL_EXPORTER_OTLP_HEADERS   — Extra exporter headers (read by the SDK)
  *     OTEL_SERVICE_NAME            — Service name tag (default: "nodetool")
  *     OTEL_TRACES_EXPORTER=console — Print spans to stdout via OTel SDK
  *     TRACELOOP_DISABLE_BATCH=true — Flush spans immediately (dev mode)
@@ -22,21 +26,28 @@
  * All NodeTool sinks emit the same {@link TraceRecord} shape (see
  * trace-exporters.ts) so a downstream agent can ingest either one.
  */
-import { createLogger } from "@nodetool-ai/config";
+import { context, propagation, trace } from "@opentelemetry/api";
+import { createLogger, setLogHook } from "@nodetool-ai/config";
+import { ContentFilteringSpanExporter, RunTraceSpanProcessor, installRunTraceLogHook } from "./run-trace-processor.js";
+import { getRunTraceScope } from "./run-trace-context.js";
+import { TRACE_SPAN_EVENT_LIMIT } from "@nodetool-ai/protocol";
 const log = createLogger("nodetool.runtime.telemetry");
 let _tracer = null;
 let _initialized = false;
+let _sdk = null;
+let _processors = [];
 /**
  * Initialize OpenTelemetry instrumentation.
  *
  * Idempotent: calling more than once is a no-op (returns the previous result).
- * Returns true if at least one sink is active, false if telemetry was skipped.
+ * The durable processor is always active. External sinks remain optional.
  */
 export async function initTelemetry(options = {}) {
     if (_initialized)
         return _tracer !== null;
     const traceloopKey = process.env["TRACELOOP_API_KEY"];
     const otlpEndpoint = process.env["OTEL_EXPORTER_OTLP_ENDPOINT"];
+    const otlpTracesEndpoint = process.env["OTEL_EXPORTER_OTLP_TRACES_ENDPOINT"];
     const consoleMode = options.console || process.env["OTEL_TRACES_EXPORTER"] === "console";
     const stdoutFormat = (() => {
         if (options.stdout === false)
@@ -52,60 +63,73 @@ export async function initTelemetry(options = {}) {
         return null;
     })();
     const traceFilePath = options.traceFile ?? process.env["NODETOOL_TRACE_FILE"];
-    const hasOtlp = !!(traceloopKey || otlpEndpoint);
-    if (!hasOtlp && !consoleMode && !stdoutFormat && !traceFilePath) {
-        _initialized = true;
-        return false;
-    }
+    const hasOtlp = !!(traceloopKey || otlpEndpoint || otlpTracesEndpoint);
     const { NodeSDK } = await import("@opentelemetry/sdk-node");
     const { resourceFromAttributes } = await import("@opentelemetry/resources");
     const { ATTR_SERVICE_NAME } = await import("@opentelemetry/semantic-conventions");
     const otelApi = await import("@opentelemetry/api");
-    const { BatchSpanProcessor, SimpleSpanProcessor, ConsoleSpanExporter } = await import("@opentelemetry/sdk-trace-base");
+    const { BatchSpanProcessor, SimpleSpanProcessor, ConsoleSpanExporter, RandomIdGenerator, AlwaysOnSampler } = await import("@opentelemetry/sdk-trace-base");
     const serviceName = options.serviceName ?? process.env["OTEL_SERVICE_NAME"] ?? "nodetool";
     const disableBatch = options.disableBatch ?? process.env["TRACELOOP_DISABLE_BATCH"] === "true";
-    const processors = [];
-    const destinations = [];
+    const processor = new RunTraceSpanProcessor();
+    const processors = [processor];
+    _processors = processors;
+    const destinations = ["run-store"];
     if (hasOtlp) {
         const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-proto");
-        const url = otlpEndpoint
-            ? `${otlpEndpoint}/v1/traces`
-            : "https://api.traceloop.com/v1/traces";
+        const url = otlpTracesEndpoint
+            ? otlpTracesEndpoint
+            : otlpEndpoint
+                ? `${otlpEndpoint.replace(/\/+$/, "")}/v1/traces`
+                : "https://api.traceloop.com/v1/traces";
         const headers = traceloopKey
             ? { Authorization: `Bearer ${traceloopKey}` }
             : {};
         const exporter = new OTLPTraceExporter({ url, headers });
         const Proc = disableBatch ? SimpleSpanProcessor : BatchSpanProcessor;
-        processors.push(new Proc(exporter));
-        destinations.push(traceloopKey ? "traceloop" : `otlp:${otlpEndpoint}`);
+        processors.push(new Proc(new ContentFilteringSpanExporter(exporter)));
+        destinations.push(traceloopKey ? "traceloop" : `otlp:${url}`);
     }
     if (consoleMode) {
-        processors.push(new SimpleSpanProcessor(new ConsoleSpanExporter()));
+        processors.push(new SimpleSpanProcessor(new ContentFilteringSpanExporter(new ConsoleSpanExporter())));
         destinations.push("otel-console");
     }
     if (stdoutFormat) {
         const { StdoutSpanExporter } = await import("./trace-exporters.js");
-        processors.push(new SimpleSpanProcessor(new StdoutSpanExporter(stdoutFormat)));
+        processors.push(new SimpleSpanProcessor(new ContentFilteringSpanExporter(new StdoutSpanExporter(stdoutFormat))));
         destinations.push(`stdout:${stdoutFormat}`);
     }
     if (traceFilePath) {
         const { JsonlFileSpanExporter } = await import("./trace-exporters.js");
         // SimpleSpanProcessor — we want the file written eagerly so a crash
         // doesn't lose recent spans, and disk I/O is cheap enough.
-        processors.push(new SimpleSpanProcessor(new JsonlFileSpanExporter(traceFilePath)));
+        processors.push(new SimpleSpanProcessor(new ContentFilteringSpanExporter(new JsonlFileSpanExporter(traceFilePath))));
         destinations.push(`file:${traceFilePath}`);
     }
+    // Outbound `fetch` (provider APIs, S3, Supabase, safeFetch) becomes
+    // `HTTP <method>` client spans. undici publishes on diagnostics_channel, so
+    // this works in ESM and in the bundled backend without a loader hook. The
+    // OTLP exporter sends over `node:http`, so it never traces itself.
+    const { UndiciInstrumentation } = await import("@opentelemetry/instrumentation-undici");
+    const ids = new RandomIdGenerator();
     const sdk = new NodeSDK({
         resource: resourceFromAttributes({ [ATTR_SERVICE_NAME]: serviceName }),
-        spanProcessors: processors
+        autoDetectResources: false,
+        spanProcessors: processors,
+        sampler: new AlwaysOnSampler(),
+        spanLimits: { eventCountLimit: TRACE_SPAN_EVENT_LIMIT },
+        idGenerator: { generateTraceId: () => getRunTraceScope()?.traceId ?? ids.generateTraceId(), generateSpanId: () => ids.generateSpanId() },
+        instrumentations: [new UndiciInstrumentation()]
     });
     // sdk.start() is typed as void in current SDK versions, but historically
     // returned a Promise — `await` is a no-op on non-thenable values, so this
     // 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;
+    installRunTraceLogHook();
     if (!options.silent) {
         log.info("OpenTelemetry initialized", {
             destinations: destinations.join(", ")
@@ -117,6 +141,32 @@ 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;
+    _processors = [];
+    if (sdk) {
+        try {
+            await sdk.shutdown();
+        }
+        catch (err) {
+            log.warn("Telemetry shutdown failed", err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    setLogHook(null);
+}
+/** Wait until the durable processor has persisted every queued completed record. */
+export async function flushTelemetry() {
+    await Promise.all(_processors.map((processor) => processor.forceFlush()));
+}
 /**
  * Reset the telemetry singleton. Test-only — production code should call
  * `initTelemetry()` exactly once at startup.
@@ -124,5 +174,11 @@ export function getTracer() {
 export function _resetTelemetryForTest() {
     _tracer = null;
     _initialized = false;
+    _sdk = null;
+    _processors = [];
+    setLogHook(null);
+    trace.disable();
+    context.disable();
+    propagation.disable();
 }
 //# 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"}