shield360 1.0.1 → 1.2.0

package/dist/otel/code-location.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeLocationSpanProcessor = exports.PathNormaliser = exports.ATTR_CODE_LINE_NUMBER = exports.ATTR_CODE_FILE_PATH = exports.ATTR_CODE_FUNCTION_NAME = void 0;
+exports.resolveCaptureCodeLocation = resolveCaptureCodeLocation;
+exports.anonymiseAbsolutePath = anonymiseAbsolutePath;
+/**
+ * Code location on GenAI spans: code.function.name, code.file.path and
+ * code.line.number of the application call site that started the span.
+ *
+ * A SpanProcessor's onStart runs synchronously inside tracer.startSpan, so
+ * the caller's stack is still live there and one processor covers every
+ * instrumentation. Only names, repo-relative paths and line numbers are
+ * captured: never argument values, locals or source text.
+ */
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const url_1 = require("url");
+const constant_1 = require("../constant");
+exports.ATTR_CODE_FUNCTION_NAME = 'code.function.name';
+exports.ATTR_CODE_FILE_PATH = 'code.file.path';
+exports.ATTR_CODE_LINE_NUMBER = 'code.line.number';
+const GEN_AI_OPERATION = 'gen_ai.operation.name';
+// These instrumentations set gen_ai.operation.name after span creation, so
+// their spans are recognised by instrumentation scope instead.
+const LATE_OPERATION_SCOPES = new Set(['langchain', 'mcp', 'browser-use'].map((n) => `${constant_1.INSTRUMENTATION_PREFIX}/instrumentation-${n}`));
+const MAX_CACHE_ENTRIES = 4096;
+const STACK_LIMIT = 64;
+const FALSY = new Set(['false', '0', 'no', 'off']);
+// The SDK's own compiled or source directory (dist/ or src/). Its tests are
+// application code for this purpose.
+const SDK_DIR = toPosix((0, path_1.resolve)(__dirname, '..'));
+/** captureCodeLocation option wins; otherwise SHIELD360_CAPTURE_CODE_LOCATION; default on. */
+function resolveCaptureCodeLocation(option) {
+    if (option !== undefined)
+        return option;
+    const env = process.env.SHIELD360_CAPTURE_CODE_LOCATION;
+    return !(env && FALSY.has(env.trim().toLowerCase()));
+}
+function toPosix(p) {
+    return p.replace(/\\/g, '/');
+}
+function stripPrefix(path, root) {
+    if (!root)
+        return undefined;
+    const r = toPosix(root).replace(/\/+$/, '');
+    if (r && path.startsWith(r + '/'))
+        return path.slice(r.length + 1);
+    return undefined;
+}
+/** CI workspace and home directory prefixes, CI first (a runner's workspace sits under its home). */
+const BUILD_HOST_PREFIXES = [
+    /^\/home\/runner\/work\/[^/]+\/[^/]+\//, // GitHub Actions
+    /^\/github\/workspace\//, // GitHub container actions
+    /^\/home\/vsts\/work\/[^/]+\/s\//, // Azure Pipelines
+    /^\/builds\/[^/]+\/[^/]+\//, // GitLab CI
+    /^\/var\/lib\/buildkite-agent\/builds\/[^/]+\/[^/]+\/[^/]+\//, // Buildkite
+    /^\/(?:var\/lib\/jenkins|var\/jenkins_home)\/workspace\/[^/]+\//, // Jenkins
+    /^\/opt\/atlassian\/pipelines\/agent\/build\//, // Bitbucket Pipelines
+    /^\/codebuild\/output\/src[^/]*\/src\//, // AWS CodeBuild
+    /^\/home\/[^/]+\//,
+    /^\/Users\/[^/]+\//,
+    /^[A-Za-z]:\/Users\/[^/]+\//,
+    /^\/root\//,
+];
+/**
+ * Drops the first home directory or CI workspace prefix of an absolute path:
+ * the last resort for a path under no code root, repository, working directory
+ * or the current user's home. Other absolute paths (/srv/app/...) are kept.
+ */
+function anonymiseAbsolutePath(path) {
+    for (const re of BUILD_HOST_PREFIXES) {
+        const m = re.exec(path);
+        if (m)
+            return path.slice(m[0].length);
+    }
+    return path;
+}
+class PathNormaliser {
+    constructor(options = {}) {
+        this.gitDirs = new Map();
+        const codeRoot = options.codeRoot ?? process.env.SHIELD360_CODE_ROOT;
+        this.codeRoot = codeRoot ? toPosix((0, path_1.resolve)(codeRoot)) : undefined;
+        this.cwd = toPosix(options.cwd ?? process.cwd());
+        this.home = toPosix(options.home ?? (0, os_1.homedir)());
+    }
+    /** Repo-relative path for a stack-frame file (path or file:// URL). */
+    normalise(file) {
+        let path = file;
+        if (path.startsWith('file://')) {
+            path = (0, url_1.fileURLToPath)(path.replace(/[?#].*$/, ''));
+        }
+        path = toPosix(path);
+        const relative = stripPrefix(path, this.codeRoot) ??
+            stripPrefix(path, this.gitRoot(path)) ??
+            stripPrefix(path, this.cwd) ??
+            stripPrefix(path, this.home) ??
+            anonymiseAbsolutePath(path);
+        return relative.replace(/^\.\//, '');
+    }
+    /** Nearest ancestor containing .git; each directory is probed at most once. */
+    gitRoot(path) {
+        let dir = (0, path_1.dirname)(path);
+        for (;;) {
+            let hasGit = this.gitDirs.get(dir);
+            if (hasGit === undefined) {
+                hasGit = (0, fs_1.existsSync)((0, path_1.join)(dir, '.git'));
+                if (this.gitDirs.size < MAX_CACHE_ENTRIES)
+                    this.gitDirs.set(dir, hasGit);
+            }
+            if (hasGit)
+                return toPosix(dir);
+            const parent = (0, path_1.dirname)(dir);
+            if (parent === dir)
+                return undefined;
+            dir = parent;
+        }
+    }
+}
+exports.PathNormaliser = PathNormaliser;
+const FRAME_RE = /^\s*at (?:(.+?) \()?(.+?):(\d+):(\d+)\)?$/;
+function isApplicationFile(file) {
+    if (file.startsWith('node:') || file.startsWith('internal/') || file.startsWith('<'))
+        return false;
+    if (!(file.startsWith('/') || file.startsWith('file://') || /^[A-Za-z]:[\\/]/.test(file))) {
+        return false;
+    }
+    const posix = toPosix(file);
+    if (posix.includes('/node_modules/'))
+        return false;
+    if (posix.startsWith(SDK_DIR + '/') && !posix.includes('/__tests__/'))
+        return false;
+    return true;
+}
+function cleanFunctionName(raw) {
+    if (!raw)
+        return undefined;
+    const name = raw
+        .replace(/^async /, '')
+        .replace(/^new /, '')
+        .replace(/ \[as [^\]]+\]$/, '')
+        .trim();
+    if (!name || name.includes('<anonymous>'))
+        return undefined;
+    return name;
+}
+class CodeLocationSpanProcessor {
+    constructor(options = {}) {
+        // Raw frame line -> parsed application frame, or null when not one.
+        this.cache = new Map();
+        this.normaliser = new PathNormaliser(options);
+    }
+    onStart(span, _parentContext) {
+        try {
+            if (!isGenAISpan(span))
+                return;
+            const attrs = span.attributes;
+            if (attrs[exports.ATTR_CODE_FUNCTION_NAME] !== undefined ||
+                attrs[exports.ATTR_CODE_FILE_PATH] !== undefined ||
+                attrs[exports.ATTR_CODE_LINE_NUMBER] !== undefined) {
+                return;
+            }
+            const frame = this.findApplicationFrame(captureStack());
+            if (!frame)
+                return;
+            if (frame.functionName)
+                span.setAttribute(exports.ATTR_CODE_FUNCTION_NAME, frame.functionName);
+            span.setAttribute(exports.ATTR_CODE_FILE_PATH, frame.filePath);
+            span.setAttribute(exports.ATTR_CODE_LINE_NUMBER, frame.lineNumber);
+        }
+        catch {
+            // Never break span creation.
+        }
+    }
+    /** Visible for tests: number of cached frame lines. */
+    get cacheSize() {
+        return this.cache.size;
+    }
+    /** First application frame in a V8 stack string. */
+    findApplicationFrame(stack) {
+        if (!stack)
+            return undefined;
+        const lines = stack.split('\n');
+        for (let i = 1; i < lines.length; i++) {
+            const frame = this.parseLine(lines[i]);
+            if (frame)
+                return frame;
+        }
+        return undefined;
+    }
+    parseLine(line) {
+        const cached = this.cache.get(line);
+        if (cached !== undefined)
+            return cached;
+        let frame = null;
+        const m = FRAME_RE.exec(line);
+        if (m && !m[2].includes('(') && isApplicationFile(m[2])) {
+            frame = {
+                functionName: cleanFunctionName(m[1]),
+                filePath: this.normaliser.normalise(m[2]),
+                lineNumber: Number(m[3]),
+            };
+        }
+        if (this.cache.size < MAX_CACHE_ENTRIES)
+            this.cache.set(line, frame);
+        return frame;
+    }
+    onEnd(_span) { }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+}
+exports.CodeLocationSpanProcessor = CodeLocationSpanProcessor;
+function isGenAISpan(span) {
+    if (span.attributes[GEN_AI_OPERATION] !== undefined)
+        return true;
+    const scope = span.instrumentationScope?.name;
+    return scope !== undefined && LATE_OPERATION_SCOPES.has(scope);
+}
+function captureStack() {
+    const previous = Error.stackTraceLimit;
+    try {
+        Error.stackTraceLimit = STACK_LIMIT;
+        return new Error().stack;
+    }
+    finally {
+        Error.stackTraceLimit = previous;
+    }
+}
+//# sourceMappingURL=code-location.js.map

package/dist/otel/code-location.js.map

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

package/dist/otel/events.d.ts

@@ -5,6 +5,7 @@ export default class Events {
     static loggerProvider: LoggerProvider;
     static logger: ReturnType<typeof logs.getLogger>;
     static setup(options: SetupEventsOptions): import("@opentelemetry/api-logs").Logger | null;
+    static ensureProvider(options: SetupEventsOptions): LoggerProvider;
     private static buildLoggerProvider;
     private static createOTLPProcessor;
     static resetForTesting(): void;

package/dist/otel/events.js

@@ -9,18 +9,7 @@ class Events {
     static setup(options) {
         try {
             if (!EVENTS_SET) {
-                const existingProvider = api_logs_1.logs.getLoggerProvider();
-                const isSDKProvider = existingProvider &&
-                    typeof existingProvider.forceFlush === 'function' &&
-                    existingProvider.constructor.name !== 'NoopLoggerProvider';
-                if (isSDKProvider) {
-                    this.loggerProvider = existingProvider;
-                }
-                else {
-                    this.loggerProvider = Events.buildLoggerProvider(options);
-                    api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
-                }
-                this.logger = this.loggerProvider.getLogger('shield360');
+                this.logger = this.ensureProvider(options).getLogger('shield360');
                 EVENTS_SET = true;
             }
             return this.logger;
@@ -30,6 +19,24 @@ class Events {
             return null;
         }
     }
+    // SHIELD: the provider on its own, so application logs (app-logs.ts) can
+    // share it — same exporter, same destination — even with GenAI events off.
+    static ensureProvider(options) {
+        if (!this.loggerProvider) {
+            const existingProvider = api_logs_1.logs.getLoggerProvider();
+            const isSDKProvider = existingProvider &&
+                typeof existingProvider.forceFlush === 'function' &&
+                existingProvider.constructor.name !== 'NoopLoggerProvider';
+            if (isSDKProvider) {
+                this.loggerProvider = existingProvider;
+            }
+            else {
+                this.loggerProvider = Events.buildLoggerProvider(options);
+                api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
+            }
+        }
+        return this.loggerProvider;
+    }
     static buildLoggerProvider(options) {
         const exporterList = (0, utils_1.parseExporters)('OTEL_LOGS_EXPORTER');
         const processors = [];
@@ -68,6 +75,8 @@ class Events {
     }
     static resetForTesting() {
         EVENTS_SET = false;
+        this.loggerProvider = undefined;
+        this.logger = undefined;
     }
 }
 exports.default = Events;

package/dist/otel/events.js.map

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

package/dist/otel/log-auto.d.ts

@@ -0,0 +1,44 @@
+/**
+ * winston and pino, bridged without code changes when application logs are on.
+ *
+ * With `captureLogs: true` (or SHIELD360_CAPTURE_LOGS=true), init() hooks the
+ * loggers an app already uses, through OpenTelemetry's module hooks
+ * (@opentelemetry/instrumentation), the way OpenTelemetry's own winston and
+ * pino instrumentations do:
+ *
+ *   winston  every winston.createLogger() also gets the Shield360 transport
+ *            (log-bridges.ts), built on the app's own winston.Transport. A
+ *            winston already loaded before init() is patched in place.
+ *   pino     every pino() logger writes to its destination and to the
+ *            Shield360 stream (pino.multistream), so output is unchanged.
+ *            Loggers created before init() are not changed: create them after
+ *            init(), or add Shield360.pinoStream() yourself.
+ *
+ * The hooks are inert while application logs are off, so turning them off
+ * later stops new loggers being bridged. Nothing here throws into the app: if
+ * a logger cannot be bridged it is created exactly as it would have been.
+ */
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from '@opentelemetry/instrumentation';
+declare const ORIGINAL: unique symbol;
+type AnyFunction = ((...args: any[]) => any) & {
+    [ORIGINAL]?: AnyFunction;
+    [key: string | symbol]: any;
+};
+/** Makes winston.createLogger() add the Shield360 transport. Returns the module. */
+export declare function patchWinston(winston: any): any;
+export declare function unpatchWinston(winston: any): void;
+/**
+ * pino's arguments with the Shield360 stream added, or null to call pino
+ * unchanged: pino(), pino(opts), pino(stream), pino(opts, stream),
+ * pino(opts, 'path'), and opts.transport.
+ */
+export declare function bridgePinoArgs(pino: AnyFunction, args: unknown[]): unknown[] | null;
+/** A pino function whose loggers also write to Shield360. Returns the module to use. */
+export declare function patchPino(pino: any): any;
+export declare class Shield360LogBridgeInstrumentation extends InstrumentationBase {
+    constructor();
+    protected init(): InstrumentationNodeModuleDefinition[];
+}
+/** Hooks winston and pino (once). Called by init() when application logs are on. */
+export declare function enableLogBridges(): void;
+export {};

package/dist/otel/log-auto.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Shield360LogBridgeInstrumentation = void 0;
+exports.patchWinston = patchWinston;
+exports.unpatchWinston = unpatchWinston;
+exports.bridgePinoArgs = bridgePinoArgs;
+exports.patchPino = patchPino;
+exports.enableLogBridges = enableLogBridges;
+/**
+ * winston and pino, bridged without code changes when application logs are on.
+ *
+ * With `captureLogs: true` (or SHIELD360_CAPTURE_LOGS=true), init() hooks the
+ * loggers an app already uses, through OpenTelemetry's module hooks
+ * (@opentelemetry/instrumentation), the way OpenTelemetry's own winston and
+ * pino instrumentations do:
+ *
+ *   winston  every winston.createLogger() also gets the Shield360 transport
+ *            (log-bridges.ts), built on the app's own winston.Transport. A
+ *            winston already loaded before init() is patched in place.
+ *   pino     every pino() logger writes to its destination and to the
+ *            Shield360 stream (pino.multistream), so output is unchanged.
+ *            Loggers created before init() are not changed: create them after
+ *            init(), or add Shield360.pinoStream() yourself.
+ *
+ * The hooks are inert while application logs are off, so turning them off
+ * later stops new loggers being bridged. Nothing here throws into the app: if
+ * a logger cannot be bridged it is created exactly as it would have been.
+ */
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const constant_1 = require("../constant");
+const app_logs_1 = require("./app-logs");
+const log_bridges_1 = require("./log-bridges");
+const ORIGINAL = Symbol.for('shield360.logBridge.original');
+const BRIDGED = Symbol.for('shield360.logBridge.transport');
+// ---------------------------------------------------------------- winston
+/** Makes winston.createLogger() add the Shield360 transport. Returns the module. */
+function patchWinston(winston) {
+    try {
+        if (!winston || typeof winston.createLogger !== 'function' || winston.createLogger[ORIGINAL])
+            return winston;
+        if (typeof winston.Transport !== 'function')
+            return winston;
+        const Shield360Transport = (0, log_bridges_1.winstonTransport)(winston.Transport);
+        const original = winston.createLogger;
+        const patched = function (...args) {
+            const logger = original.apply(this, args);
+            if (!(0, app_logs_1.appLogsEnabled)())
+                return logger;
+            try {
+                const transports = Array.isArray(logger?.transports) ? logger.transports : [];
+                if (!transports.some((t) => t?.[BRIDGED])) {
+                    const transport = new Shield360Transport();
+                    transport[BRIDGED] = true;
+                    logger.add(transport);
+                }
+            }
+            catch {
+                // The logger works as created.
+            }
+            return logger;
+        };
+        patched[ORIGINAL] = original;
+        winston.createLogger = patched;
+    }
+    catch {
+        // Left unpatched.
+    }
+    return winston;
+}
+function unpatchWinston(winston) {
+    try {
+        const original = winston?.createLogger?.[ORIGINAL];
+        if (original)
+            winston.createLogger = original;
+    }
+    catch {
+        // Nothing to undo.
+    }
+}
+// ------------------------------------------------------------------- pino
+function isStream(value) {
+    return !!value && typeof value.write === 'function';
+}
+/**
+ * pino's arguments with the Shield360 stream added, or null to call pino
+ * unchanged: pino(), pino(opts), pino(stream), pino(opts, stream),
+ * pino(opts, 'path'), and opts.transport.
+ */
+function bridgePinoArgs(pino, args) {
+    let [opts, stream] = args;
+    if (args.length > 2)
+        return null;
+    if (stream === undefined && (isStream(opts) || typeof opts === 'string')) {
+        stream = opts;
+        opts = {};
+    }
+    if (opts === undefined || opts === null)
+        opts = {};
+    if (typeof opts !== 'object' || Array.isArray(opts))
+        return null;
+    let options = opts;
+    if (typeof pino.multistream !== 'function' || typeof pino.destination !== 'function')
+        return null;
+    if (options.transport) {
+        if (stream !== undefined)
+            return null; // pino refuses both; let it say so
+        if (typeof pino.transport !== 'function')
+            return null;
+        stream = pino.transport(options.transport);
+        options = { ...options };
+        delete options.transport;
+    }
+    if (stream === undefined)
+        stream = pino.destination((process.stdout && process.stdout.fd) || 1);
+    else if (typeof stream === 'string' || typeof stream === 'number')
+        stream = pino.destination(stream);
+    if (!isStream(stream))
+        return null;
+    // levelVal 0: both streams see every record the logger itself lets through.
+    const streams = pino.multistream([
+        { levelVal: 0, stream },
+        { levelVal: 0, stream: (0, log_bridges_1.pinoStream)() },
+    ]);
+    return [options, streams];
+}
+/** A pino function whose loggers also write to Shield360. Returns the module to use. */
+function patchPino(pino) {
+    try {
+        if (typeof pino !== 'function' || pino[ORIGINAL])
+            return pino;
+        const original = pino;
+        const patched = function (...args) {
+            if ((0, app_logs_1.appLogsEnabled)()) {
+                let bridged = null;
+                try {
+                    bridged = bridgePinoArgs(original, args);
+                }
+                catch {
+                    bridged = null;
+                }
+                if (bridged)
+                    return original.apply(this, bridged);
+            }
+            return original.apply(this, args);
+        };
+        Object.assign(patched, original);
+        patched[ORIGINAL] = original;
+        patched.default = patched;
+        patched.pino = patched;
+        return patched;
+    }
+    catch {
+        return pino;
+    }
+}
+// -------------------------------------------------------------- the hooks
+class Shield360LogBridgeInstrumentation extends instrumentation_1.InstrumentationBase {
+    constructor() {
+        super(`${constant_1.INSTRUMENTATION_PREFIX}/instrumentation-log-bridges`, '1.0.0', {});
+    }
+    init() {
+        return [
+            new instrumentation_1.InstrumentationNodeModuleDefinition('winston', ['>=3 <4'], (moduleExports) => patchWinston(moduleExports), (moduleExports) => unpatchWinston(moduleExports)),
+            new instrumentation_1.InstrumentationNodeModuleDefinition('pino', ['>=7 <11'], (moduleExports) => patchPino(moduleExports), 
+            // The patched function is inert while application logs are off.
+            (moduleExports) => moduleExports),
+        ];
+    }
+}
+exports.Shield360LogBridgeInstrumentation = Shield360LogBridgeInstrumentation;
+let instrumentation = null;
+/** winston loaded before init(): patched in place, since its createLogger is read at call time. */
+function patchLoadedWinston() {
+    try {
+        const cache = typeof require !== 'undefined' ? require.cache : undefined;
+        if (!cache)
+            return;
+        for (const [file, mod] of Object.entries(cache)) {
+            if (mod && /[\\/]node_modules[\\/]winston[\\/]lib[\\/]winston\.js$/.test(file))
+                patchWinston(mod.exports);
+        }
+    }
+    catch {
+        // Nothing loaded, or nothing to patch.
+    }
+}
+/** Hooks winston and pino (once). Called by init() when application logs are on. */
+function enableLogBridges() {
+    try {
+        if (!instrumentation)
+            instrumentation = new Shield360LogBridgeInstrumentation();
+        else
+            instrumentation.enable();
+        patchLoadedWinston();
+    }
+    catch {
+        // Application logs still work through Shield360.logger() and the explicit bridges.
+    }
+}
+//# sourceMappingURL=log-auto.js.map

package/dist/otel/log-auto.js.map

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

package/dist/otel/log-bridges.d.ts

@@ -0,0 +1,54 @@
+import { createLimiter, type LogLevel } from './app-logs';
+export { createLimiter };
+export type BridgeOptions = {
+    /** The instrumentation scope; defaults to the bridge's name (pino, winston, console). */
+    name?: string;
+    /** Records per second at most (default 500). */
+    maxPerSecond?: number;
+};
+export declare function pinoLevel(level: unknown): LogLevel;
+/**
+ * A pino destination: `pino({}, pino.multistream([{ stream: process.stdout }, { stream: Shield360.pinoStream() }]))`.
+ * Each line pino writes is one JSON record; `msg` becomes the body, `level`
+ * the severity, `err` the exception attributes, the rest attributes.
+ */
+export declare function pinoStream(options?: BridgeOptions): {
+    write(line: string): boolean;
+};
+type TransportBase = new (options?: Record<string, unknown>) => {
+    emit?(event: string, ...args: unknown[]): boolean;
+};
+export declare function winstonLevel(level: unknown): LogLevel;
+/**
+ * A winston transport class on the app's own `winston-transport`:
+ *
+ *   import Transport from 'winston-transport';
+ *   const Shield360Transport = Shield360.winstonTransport(Transport);
+ *   winston.createLogger({ transports: [new winston.transports.Console(), new Shield360Transport()] });
+ */
+export declare function winstonTransport(Transport: TransportBase, options?: BridgeOptions): {
+    new (options?: Record<string, unknown>): {
+        log(info: Record<string | symbol, unknown>, callback?: () => void): void;
+        emit?(event: string, ...args: unknown[]): boolean;
+    };
+};
+/** Copies console output to Shield360 application logs (still printed as before). Call releaseConsole() to stop. */
+export declare function captureConsole(options?: BridgeOptions): void;
+/** Puts console back as it was. */
+export declare function releaseConsole(): void;
+type WritableLike = {
+    write: (...args: any[]) => boolean;
+};
+export type StdioOptions = BridgeOptions & {
+    /** The streams to copy; process.stdout and process.stderr by default (tests pass their own). */
+    stdout?: WritableLike;
+    stderr?: WritableLike;
+};
+/**
+ * Copies every line written to stdout and stderr to Shield360 application logs; the output itself
+ * is unchanged. JSON lines keep their level, message, fields and error; plain lines are info on
+ * stdout and error on stderr. Lines split across writes are joined. Call releaseStdio() to stop.
+ */
+export declare function captureStdio(options?: StdioOptions): void;
+/** Puts stdout and stderr back as they were. */
+export declare function releaseStdio(): void;