@thenewlabs/entangle-utils 1.0.0

package/dist/browser.d.ts

@@ -0,0 +1,4 @@
+export * from './validation.js';
+export * from './counters.js';
+export * from './stream-counters.js';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/browser.js

@@ -0,0 +1,5 @@
+// Browser-safe exports (no Node.js dependencies)
+export * from './validation.js';
+export * from './counters.js';
+export * from './stream-counters.js';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+export declare function loadConfig(): void;
+export interface Config {
+    port: number;
+    host: string;
+    publicOrigin: string;
+    maxFrameBytes: number;
+    relayIdleTimeoutMs: number;
+    agentHeartbeatMs: number;
+    cmdDefaultWallMs: number;
+    ttyIdleTimeoutMs: number;
+    maxOutBytes: number;
+    logLevel: string;
+    relayRateRps: number;
+    relayBurst: number;
+    agentShell: string;
+    agentDefaultCwd: string;
+    agentAllowedCwd: string[] | undefined;
+    spawnSandbox: string;
+    maxArgCount: number;
+    maxArgLen: number;
+    relayUrl: string | undefined;
+}
+export declare function getConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAwBlC"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import { config } from 'dotenv';
+import { resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function loadConfig() {
+    const rootDir = resolve(__dirname, '../../..');
+    const envPath = resolve(rootDir, '.env');
+    config({ path: envPath });
+}
+export function getConfig() {
+    loadConfig();
+    return {
+        port: parseInt(process.env.PORT || '8080', 10),
+        host: process.env.HOST || '0.0.0.0',
+        publicOrigin: process.env.PUBLIC_ORIGIN || 'http://localhost:8080',
+        maxFrameBytes: parseInt(process.env.MAX_FRAME_BYTES || '1048576', 10),
+        relayIdleTimeoutMs: parseInt(process.env.RELAY_IDLE_TIMEOUT_MS || '120000', 10),
+        agentHeartbeatMs: parseInt(process.env.AGENT_HEARTBEAT_MS || '15000', 10),
+        cmdDefaultWallMs: parseInt(process.env.CMD_DEFAULT_WALL_MS || '60000', 10),
+        ttyIdleTimeoutMs: parseInt(process.env.TTY_IDLE_TIMEOUT_MS || '1200000', 10),
+        maxOutBytes: parseInt(process.env.MAX_OUT_BYTES || '10485760', 10),
+        logLevel: process.env.LOG_LEVEL || 'info',
+        relayRateRps: parseInt(process.env.RELAY_RATE_RPS || '10', 10),
+        relayBurst: parseInt(process.env.RELAY_BURST || '50', 10),
+        agentShell: process.env.AGENT_SHELL || process.env.SHELL || '/bin/bash',
+        agentDefaultCwd: process.env.AGENT_DEFAULT_CWD || process.env.HOME || process.cwd(),
+        agentAllowedCwd: process.env.AGENT_ALLOWED_CWD?.split(':').filter(Boolean),
+        spawnSandbox: process.env.SPAWN_SANDBOX || 'none',
+        maxArgCount: parseInt(process.env.MAX_ARG_COUNT || '256', 10),
+        maxArgLen: parseInt(process.env.MAX_ARG_LEN || '16384', 10),
+        relayUrl: process.env.RELAY_URL,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC;AAwBD,MAAM,UAAU,SAAS;IACvB,UAAU,EAAE,CAAC;IAEb,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,SAAS;QACnC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB;QAClE,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS,EAAE,EAAE,CAAC;QACrE,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,EAAE,EAAE,CAAC;QAC/E,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,EAAE,EAAE,CAAC;QACzE,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1E,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,EAAE,EAAE,CAAC;QAC5E,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU,EAAE,EAAE,CAAC;QAClE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACzC,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,EAAE,CAAC;QAC9D,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC;QACzD,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW;QACvE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE;QACnF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1E,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM;QACjD,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,KAAK,EAAE,EAAE,CAAC;QAC7D,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC;QAC3D,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;KAChC,CAAC;AACJ,CAAC"}

package/dist/counters.d.ts

@@ -0,0 +1,11 @@
+export declare class MonotonicCounter {
+    private lastSeen;
+    validate(ctr: number): void;
+    next(): number;
+    current(): number;
+}
+export declare class BidirectionalCounters {
+    readonly incoming: MonotonicCounter;
+    readonly outgoing: MonotonicCounter;
+}
+//# sourceMappingURL=counters.d.ts.map

package/dist/counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.d.ts","sourceRoot":"","sources":["../src/counters.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAc;IAE9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO3B,IAAI,IAAI,MAAM;IAId,OAAO,IAAI,MAAM;CAGlB;AAED,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,QAAQ,mBAA0B;IAC3C,QAAQ,CAAC,QAAQ,mBAA0B;CAC5C"}

package/dist/counters.js

@@ -0,0 +1,20 @@
+export class MonotonicCounter {
+    lastSeen = -1;
+    validate(ctr) {
+        if (ctr <= this.lastSeen) {
+            throw new Error(`Counter not strictly increasing: ${ctr} <= ${this.lastSeen}`);
+        }
+        this.lastSeen = ctr;
+    }
+    next() {
+        return ++this.lastSeen;
+    }
+    current() {
+        return this.lastSeen;
+    }
+}
+export class BidirectionalCounters {
+    incoming = new MonotonicCounter();
+    outgoing = new MonotonicCounter();
+}
+//# sourceMappingURL=counters.js.map

package/dist/counters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.js","sourceRoot":"","sources":["../src/counters.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAW,CAAC,CAAC,CAAC;IAE9B,QAAQ,CAAC,GAAW;QAClB,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,IAAI;QACF,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IACvB,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAClC,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;CAC5C"}

package/dist/counters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=counters.test.d.ts.map

package/dist/counters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.test.d.ts","sourceRoot":"","sources":["../src/counters.test.ts"],"names":[],"mappings":""}

package/dist/counters.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+import { MonotonicCounter, BidirectionalCounters } from './counters.js';
+describe('Counters', () => {
+    describe('MonotonicCounter', () => {
+        it('should start at -1', () => {
+            const counter = new MonotonicCounter();
+            expect(counter.current()).toBe(-1);
+        });
+        it('should increment with next()', () => {
+            const counter = new MonotonicCounter();
+            expect(counter.next()).toBe(0);
+            expect(counter.next()).toBe(1);
+            expect(counter.next()).toBe(2);
+            expect(counter.current()).toBe(2);
+        });
+        it('should validate strictly increasing values', () => {
+            const counter = new MonotonicCounter();
+            expect(() => counter.validate(0)).not.toThrow();
+            expect(() => counter.validate(1)).not.toThrow();
+            expect(() => counter.validate(2)).not.toThrow();
+        });
+        it('should reject non-increasing values', () => {
+            const counter = new MonotonicCounter();
+            counter.validate(5);
+            expect(() => counter.validate(5))
+                .toThrow('Counter not strictly increasing: 5 <= 5');
+            expect(() => counter.validate(4))
+                .toThrow('Counter not strictly increasing: 4 <= 5');
+        });
+        it('should reject zero after positive value', () => {
+            const counter = new MonotonicCounter();
+            counter.validate(10);
+            expect(() => counter.validate(0))
+                .toThrow('Counter not strictly increasing: 0 <= 10');
+        });
+        it('should handle large values', () => {
+            const counter = new MonotonicCounter();
+            counter.validate(1000000);
+            expect(() => counter.validate(1000001)).not.toThrow();
+            expect(counter.current()).toBe(1000001);
+        });
+    });
+    describe('BidirectionalCounters', () => {
+        it('should maintain separate incoming and outgoing counters', () => {
+            const counters = new BidirectionalCounters();
+            expect(counters.incoming.current()).toBe(-1);
+            expect(counters.outgoing.current()).toBe(-1);
+        });
+        it('should increment counters independently', () => {
+            const counters = new BidirectionalCounters();
+            expect(counters.incoming.next()).toBe(0);
+            expect(counters.incoming.next()).toBe(1);
+            expect(counters.outgoing.next()).toBe(0);
+            expect(counters.outgoing.next()).toBe(1);
+            expect(counters.outgoing.next()).toBe(2);
+            expect(counters.incoming.current()).toBe(1);
+            expect(counters.outgoing.current()).toBe(2);
+        });
+        it('should validate counters independently', () => {
+            const counters = new BidirectionalCounters();
+            counters.incoming.validate(5);
+            counters.outgoing.validate(10);
+            expect(() => counters.incoming.validate(6)).not.toThrow();
+            expect(() => counters.outgoing.validate(11)).not.toThrow();
+            expect(() => counters.incoming.validate(5))
+                .toThrow('Counter not strictly increasing: 5 <= 6');
+            expect(() => counters.outgoing.validate(10))
+                .toThrow('Counter not strictly increasing: 10 <= 11');
+        });
+    });
+});
+//# sourceMappingURL=counters.test.js.map

package/dist/counters.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config.js';
+export * from './validation.js';
+export * from './counters.js';
+export * from './stream-counters.js';
+export * from './version.js';
+export * from './output.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './config.js';
+export * from './validation.js';
+export * from './counters.js';
+export * from './stream-counters.js';
+export * from './version.js';
+export * from './output.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+import pino from 'pino';
+export declare function createLogger(name: string, outputMode?: string): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAmD3E"}

package/dist/logger.js

@@ -0,0 +1,49 @@
+import pino from 'pino';
+import { Writable } from 'stream';
+import { OutputHandler, parseOutputMode } from './output.js';
+export function createLogger(name, outputMode) {
+    const level = process.env.LOG_LEVEL || 'info';
+    const mode = parseOutputMode(outputMode || process.env.OUTPUT_MODE);
+    const outputHandler = new OutputHandler({ mode });
+    // Create a custom writable stream that routes Pino logs through OutputHandler
+    const destination = new Writable({
+        write(chunk, _encoding, callback) {
+            try {
+                const str = typeof chunk === 'string' ? chunk : chunk.toString();
+                const obj = JSON.parse(str);
+                const { level: lvl, msg, ...data } = obj;
+                // Convert pino numeric level to name; if already a string, keep it
+                const levelName = typeof lvl === 'number'
+                    ? (pino.levels.labels[lvl] || 'info')
+                    : (typeof lvl === 'string' ? lvl : 'info');
+                // Remove boilerplate fields
+                if (data.name === name)
+                    delete data.name;
+                delete data.time;
+                delete data.pid;
+                delete data.hostname;
+                const hasData = Object.keys(data).length > 0;
+                outputHandler.log(levelName, msg, hasData ? data : undefined);
+            }
+            catch (_err) {
+                // Fallback for non-JSON chunk
+                const str = typeof chunk === 'string' ? chunk : chunk.toString();
+                outputHandler.write(str);
+            }
+            finally {
+                callback();
+            }
+        }
+    });
+    const logger = pino({
+        name,
+        level,
+        formatters: {
+            level: (label) => ({ level: label }),
+        },
+    }, destination);
+    // Attach outputHandler for direct access if needed
+    logger.outputHandler = outputHandler;
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM7D,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,UAAmB;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,8EAA8E;IAC9E,MAAM,WAAW,GAAG,IAAI,QAAQ,CAAC;QAC/B,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,GAAU,CAAC;gBAEhD,mEAAmE;gBACnE,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,QAAQ;oBACvC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAsC,CAAC,IAAI,MAAM,CAAC;oBACxE,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAEzD,4BAA4B;gBAC5B,IAAK,IAAY,CAAC,IAAI,KAAK,IAAI;oBAAE,OAAQ,IAAY,CAAC,IAAI,CAAC;gBAC3D,OAAQ,IAAY,CAAC,IAAI,CAAC;gBAC1B,OAAQ,IAAY,CAAC,GAAG,CAAC;gBACzB,OAAQ,IAAY,CAAC,QAAQ,CAAC;gBAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC7C,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACd,8BAA8B;gBAC9B,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;oBAAS,CAAC;gBACT,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CACjB;QACE,IAAI;QACJ,KAAK;QACL,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SAC7C;KACF,EACD,WAAgD,CAC7B,CAAC;IAEtB,mDAAmD;IACnD,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,26 @@
+export declare enum OutputMode {
+    TEXT = "text",
+    STREAM_JSON = "stream-json"
+}
+export interface OutputOptions {
+    mode: OutputMode;
+    timestamp?: boolean;
+}
+export declare class OutputHandler {
+    private mode;
+    private timestamp;
+    constructor(options?: OutputOptions);
+    log(level: string, message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    error(message: string, data?: any): void;
+    debug(message: string, data?: any): void;
+    warn(message: string, data?: any): void;
+    text(message: string, data?: any): void;
+    write(data: string | Buffer): void;
+    version(name: string, version: string): void;
+    private textOutput;
+    private formatLevel;
+    private jsonOutput;
+}
+export declare function parseOutputMode(mode: string | undefined): OutputMode;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,WAAW,gBAAgB;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,SAAS,CAAU;gBAEf,OAAO,GAAE,aAAyC;IAK9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAcrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAKvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAclC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAc5C,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,UAAU;CAUnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CASpE"}

package/dist/output.js

@@ -0,0 +1,119 @@
+export var OutputMode;
+(function (OutputMode) {
+    OutputMode["TEXT"] = "text";
+    OutputMode["STREAM_JSON"] = "stream-json";
+})(OutputMode || (OutputMode = {}));
+export class OutputHandler {
+    mode;
+    timestamp;
+    constructor(options = { mode: OutputMode.TEXT }) {
+        this.mode = options.mode;
+        this.timestamp = options.timestamp ?? false;
+    }
+    log(level, message, data) {
+        const timestamp = this.timestamp ? new Date().toISOString() : undefined;
+        switch (this.mode) {
+            case OutputMode.TEXT:
+                this.textOutput(level, message, data);
+                break;
+            case OutputMode.STREAM_JSON:
+                this.jsonOutput(level, message, data, timestamp);
+                break;
+        }
+    }
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    text(message, data) {
+        this.log('text', message, data);
+    }
+    // Direct output for things like command output
+    write(data) {
+        if (this.mode === OutputMode.TEXT) {
+            process.stdout.write(data);
+        }
+        else {
+            const output = {
+                type: 'output',
+                data: data.toString(),
+                timestamp: this.timestamp ? new Date().toISOString() : undefined,
+            };
+            console.log(JSON.stringify(output));
+        }
+    }
+    // Version output
+    version(name, version) {
+        if (this.mode === OutputMode.TEXT) {
+            console.log(`${name} ${version}`);
+        }
+        else {
+            const output = {
+                type: 'version',
+                name,
+                version,
+                timestamp: this.timestamp ? new Date().toISOString() : undefined,
+            };
+            console.log(JSON.stringify(output));
+        }
+    }
+    textOutput(level, message, data) {
+        // Format level with consistent width and color codes (if terminal supports)
+        const levelFormatted = this.formatLevel(level);
+        const levelAndMessage = [levelFormatted, message].filter(x => x).join(' ');
+        if (data && Object.keys(data).length > 0) {
+            console.log(`${levelAndMessage}`, data);
+        }
+        else {
+            console.log(`${levelAndMessage}`);
+        }
+    }
+    formatLevel(level) {
+        // Add color codes if we're in a TTY
+        const isTTY = process.stdout.isTTY;
+        const colors = {
+            error: '\x1b[31m', // Red
+            warn: '\x1b[33m', // Yellow
+            info: '\x1b[36m', // Cyan
+            debug: '\x1b[90m', // Gray
+            reset: '\x1b[0m'
+        };
+        const levelUpper = level.toLowerCase();
+        if (isTTY && colors[level]) {
+            return `${colors[level]}[${levelUpper}]${colors.reset}`;
+        }
+        if (level === 'text') {
+            return '';
+        }
+        return `[${levelUpper}]`;
+    }
+    jsonOutput(level, message, data, timestamp) {
+        const output = {
+            type: 'log',
+            level,
+            message,
+            ...(data && { data }),
+            ...(timestamp && { timestamp }),
+        };
+        console.log(JSON.stringify(output));
+    }
+}
+export function parseOutputMode(mode) {
+    switch (mode?.toLowerCase()) {
+        case 'stream-json':
+        case 'json':
+            return OutputMode.STREAM_JSON;
+        case 'text':
+        default:
+            return OutputMode.TEXT;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/stream-counters.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-stream counter management for multi-stream protocol
+ */
+export declare class StreamCounters {
+    private streamCounters;
+    /**
+     * Get counter for a stream, creating if needed
+     */
+    private getStreamCounter;
+    /**
+     * Get next expected counter value
+     */
+    getNext(sid: string, direction: 'incoming' | 'outgoing'): number;
+    /**
+     * Increment counter after successful validation
+     */
+    increment(sid: string, direction: 'incoming' | 'outgoing'): number;
+    /**
+     * Remove counters for a stream
+     */
+    removeStream(sid: string): void;
+    /**
+     * Get all stream IDs
+     */
+    getStreamIds(): string[];
+    /**
+     * Clear all counters
+     */
+    clear(): void;
+}
+//# sourceMappingURL=stream-counters.d.ts.map

package/dist/stream-counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-counters.d.ts","sourceRoot":"","sources":["../src/stream-counters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAA6D;IAEnF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM;IAKhE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM;IAOlE;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/stream-counters.js

@@ -0,0 +1,52 @@
+/**
+ * Per-stream counter management for multi-stream protocol
+ */
+export class StreamCounters {
+    streamCounters = new Map();
+    /**
+     * Get counter for a stream, creating if needed
+     */
+    getStreamCounter(sid) {
+        let counter = this.streamCounters.get(sid);
+        if (!counter) {
+            counter = { incoming: 0, outgoing: 0 };
+            this.streamCounters.set(sid, counter);
+        }
+        return counter;
+    }
+    /**
+     * Get next expected counter value
+     */
+    getNext(sid, direction) {
+        const counter = this.getStreamCounter(sid);
+        return counter[direction];
+    }
+    /**
+     * Increment counter after successful validation
+     */
+    increment(sid, direction) {
+        const counter = this.getStreamCounter(sid);
+        const value = counter[direction];
+        counter[direction]++;
+        return value;
+    }
+    /**
+     * Remove counters for a stream
+     */
+    removeStream(sid) {
+        this.streamCounters.delete(sid);
+    }
+    /**
+     * Get all stream IDs
+     */
+    getStreamIds() {
+        return Array.from(this.streamCounters.keys());
+    }
+    /**
+     * Clear all counters
+     */
+    clear() {
+        this.streamCounters.clear();
+    }
+}
+//# sourceMappingURL=stream-counters.js.map

package/dist/stream-counters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-counters.js","sourceRoot":"","sources":["../src/stream-counters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,cAAc,GAAG,IAAI,GAAG,EAAkD,CAAC;IAEnF;;OAEG;IACK,gBAAgB,CAAC,GAAW;QAClC,IAAI,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW,EAAE,SAAkC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,GAAW,EAAE,SAAkC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/validation.d.ts

@@ -0,0 +1,9 @@
+export declare function validateArguments(argv: string[], maxCount: number, maxLen: number): void;
+export declare function validateCwd(cwd: string, allowedPrefixes?: string[]): void;
+export declare function validateLimits(limits?: {
+    cpuMs?: number;
+    memMB?: number;
+    wallMs?: number;
+    maxOutBytes?: number;
+}): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAsBxF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAqBzE;AA4BD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAkBP"}

package/dist/validation.js

@@ -0,0 +1,79 @@
+import { DEFAULT_LIMITS } from '@thenewlabs/entangle-protocol';
+export function validateArguments(argv, maxCount, maxLen) {
+    if (argv.length > maxCount) {
+        throw new Error(`Too many arguments: ${argv.length} > ${maxCount}`);
+    }
+    for (const arg of argv) {
+        if (arg.length > maxLen) {
+            throw new Error(`Argument too long: ${arg.length} > ${maxLen}`);
+        }
+        if (arg.includes('\0')) {
+            throw new Error('Arguments cannot contain NUL bytes');
+        }
+        for (let i = 0; i < arg.length; i++) {
+            const code = arg.charCodeAt(i);
+            if ((code >= 0xD800 && code <= 0xDBFF) && (i + 1 >= arg.length ||
+                arg.charCodeAt(i + 1) < 0xDC00 || arg.charCodeAt(i + 1) > 0xDFFF)) {
+                throw new Error('Arguments cannot contain unpaired surrogates');
+            }
+        }
+    }
+}
+export function validateCwd(cwd, allowedPrefixes) {
+    if (!allowedPrefixes || allowedPrefixes.length === 0) {
+        return;
+    }
+    // Normalize path separators
+    const normalized = cwd.replace(/\\/g, '/');
+    // Resolve relative path components like '../' to prevent traversal
+    const resolved = resolvePath(normalized);
+    const allowed = allowedPrefixes.some(prefix => {
+        const normalizedPrefix = prefix.replace(/\\/g, '/');
+        // Remove trailing slash from prefix for consistent comparison
+        const cleanPrefix = normalizedPrefix.endsWith('/') ? normalizedPrefix.slice(0, -1) : normalizedPrefix;
+        return resolved.startsWith(cleanPrefix + '/') || resolved === cleanPrefix;
+    });
+    if (!allowed) {
+        throw new Error(`CWD not in allowed directories: ${cwd}`);
+    }
+}
+// Simple path resolution to handle '..' and '.' components
+function resolvePath(path) {
+    if (!path.startsWith('/')) {
+        // Convert relative paths to absolute by prefixing with '/'
+        path = '/' + path;
+    }
+    const parts = path.split('/').filter(Boolean);
+    const resolved = [];
+    for (const part of parts) {
+        if (part === '..') {
+            // Go up one directory (remove last component)
+            if (resolved.length > 0) {
+                resolved.pop();
+            }
+            // If we're already at root, ignore additional '..'
+        }
+        else if (part !== '.') {
+            // Add normal directory component (ignore '.')
+            resolved.push(part);
+        }
+    }
+    return '/' + resolved.join('/');
+}
+export function validateLimits(limits) {
+    if (!limits)
+        return;
+    if (limits.cpuMs !== undefined && (limits.cpuMs <= 0 || limits.cpuMs > DEFAULT_LIMITS.MAX_CPU_MS)) {
+        throw new Error(`Invalid CPU limit: ${limits.cpuMs}`);
+    }
+    if (limits.memMB !== undefined && (limits.memMB <= 0 || limits.memMB > DEFAULT_LIMITS.MAX_MEM_MB)) {
+        throw new Error(`Invalid memory limit: ${limits.memMB}`);
+    }
+    if (limits.wallMs !== undefined && (limits.wallMs <= 0 || limits.wallMs > DEFAULT_LIMITS.MAX_WALL_MS)) {
+        throw new Error(`Invalid wall time limit: ${limits.wallMs}`);
+    }
+    if (limits.maxOutBytes !== undefined && (limits.maxOutBytes <= 0 || limits.maxOutBytes > DEFAULT_LIMITS.MAX_OUT_BYTES)) {
+        throw new Error(`Invalid output limit: ${limits.maxOutBytes}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../src/validation.test.ts"],"names":[],"mappings":""}

package/dist/validation.test.js

@@ -0,0 +1,121 @@
+import { describe, it, expect } from 'vitest';
+import { validateArguments, validateCwd, validateLimits } from './validation.js';
+describe('Validation Utils', () => {
+    describe('validateArguments', () => {
+        it('should accept valid arguments', () => {
+            const argv = ['--help', 'test', 'file.txt'];
+            expect(() => validateArguments(argv, 10, 100)).not.toThrow();
+        });
+        it('should reject too many arguments', () => {
+            const argv = new Array(10).fill('arg');
+            expect(() => validateArguments(argv, 5, 100))
+                .toThrow('Too many arguments: 10 > 5');
+        });
+        it('should reject arguments that are too long', () => {
+            const argv = ['x'.repeat(101)];
+            expect(() => validateArguments(argv, 10, 100))
+                .toThrow('Argument too long: 101 > 100');
+        });
+        it('should reject arguments with NUL bytes', () => {
+            const argv = ['test\0arg'];
+            expect(() => validateArguments(argv, 10, 100))
+                .toThrow('Arguments cannot contain NUL bytes');
+        });
+        it('should reject arguments with unpaired surrogates', () => {
+            const argv = ['test\uD800'];
+            expect(() => validateArguments(argv, 10, 100))
+                .toThrow('Arguments cannot contain unpaired surrogates');
+        });
+        it('should accept empty arguments array', () => {
+            expect(() => validateArguments([], 10, 100)).not.toThrow();
+        });
+        it('should accept arguments with paired surrogates', () => {
+            const argv = ['test\uD800\uDC00']; // Valid surrogate pair
+            expect(() => validateArguments(argv, 10, 100)).not.toThrow();
+        });
+    });
+    describe('validateCwd', () => {
+        it('should accept any cwd when no prefixes specified', () => {
+            expect(() => validateCwd('/any/path')).not.toThrow();
+            expect(() => validateCwd('/etc/passwd')).not.toThrow();
+        });
+        it('should accept cwd with empty prefixes array', () => {
+            expect(() => validateCwd('/any/path', [])).not.toThrow();
+        });
+        it('should accept cwd matching allowed prefix', () => {
+            const prefixes = ['/home', '/srv'];
+            expect(() => validateCwd('/home/user/project', prefixes)).not.toThrow();
+            expect(() => validateCwd('/srv/app', prefixes)).not.toThrow();
+        });
+        it('should reject cwd not matching any prefix', () => {
+            const prefixes = ['/home', '/srv'];
+            expect(() => validateCwd('/etc/passwd', prefixes))
+                .toThrow('CWD not in allowed directories: /etc/passwd');
+        });
+        it('should normalize Windows paths', () => {
+            const prefixes = ['/home'];
+            expect(() => validateCwd('\\home\\user', prefixes)).not.toThrow();
+        });
+        it('should handle trailing slashes', () => {
+            const prefixes = ['/home/'];
+            expect(() => validateCwd('/home/user', prefixes)).not.toThrow();
+        });
+    });
+    describe('validateLimits', () => {
+        it('should accept undefined limits', () => {
+            expect(() => validateLimits()).not.toThrow();
+        });
+        it('should accept valid limits', () => {
+            const limits = {
+                cpuMs: 1000,
+                memMB: 256,
+                wallMs: 5000,
+                maxOutBytes: 1024,
+            };
+            expect(() => validateLimits(limits)).not.toThrow();
+        });
+        it('should reject zero CPU limit', () => {
+            expect(() => validateLimits({ cpuMs: 0 }))
+                .toThrow('Invalid CPU limit: 0');
+        });
+        it('should reject negative CPU limit', () => {
+            expect(() => validateLimits({ cpuMs: -1 }))
+                .toThrow('Invalid CPU limit: -1');
+        });
+        it('should reject CPU limit exceeding max', () => {
+            expect(() => validateLimits({ cpuMs: 100000 }))
+                .toThrow('Invalid CPU limit: 100000');
+        });
+        it('should reject zero memory limit', () => {
+            expect(() => validateLimits({ memMB: 0 }))
+                .toThrow('Invalid memory limit: 0');
+        });
+        it('should reject memory limit exceeding max', () => {
+            expect(() => validateLimits({ memMB: 1024 }))
+                .toThrow('Invalid memory limit: 1024');
+        });
+        it('should reject zero wall time limit', () => {
+            expect(() => validateLimits({ wallMs: 0 }))
+                .toThrow('Invalid wall time limit: 0');
+        });
+        it('should reject wall time limit exceeding max', () => {
+            expect(() => validateLimits({ wallMs: 400000 }))
+                .toThrow('Invalid wall time limit: 400000');
+        });
+        it('should reject zero output limit', () => {
+            expect(() => validateLimits({ maxOutBytes: 0 }))
+                .toThrow('Invalid output limit: 0');
+        });
+        it('should reject output limit exceeding max', () => {
+            expect(() => validateLimits({ maxOutBytes: 20000000 }))
+                .toThrow('Invalid output limit: 20000000');
+        });
+        it('should accept partial limits', () => {
+            expect(() => validateLimits({ cpuMs: 1000 })).not.toThrow();
+            expect(() => validateLimits({ memMB: 256 })).not.toThrow();
+            expect(() => validateLimits({ wallMs: 5000 })).not.toThrow();
+            expect(() => validateLimits({ maxOutBytes: 1024 })).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/validation.test.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare const VERSION = "1.0.0";
+export declare const BUILD_TIME: string;
+export declare function getVersionInfo(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,UAAU,QAA2B,CAAC;AAEnD,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+export const VERSION = '1.0.0';
+export const BUILD_TIME = new Date().toISOString();
+export function getVersionInfo() {
+    return `v${VERSION} (built: ${BUILD_TIME})`;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,YAAY,UAAU,GAAG,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@thenewlabs/entangle-utils",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@thenewlabs/entangle-protocol": "^1.0.0",
+    "dotenv": "^17.4.2",
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist"
+  ]
+}