@roj-ai/sdk 0.1.36 → 0.2.1

package/dist/lib/logger/file.js

@@ -1,54 +1,43 @@
+import { JsonlLogger } from './jsonl.js';
+/**
+ * Appends in flight per path, so lines land in the order they were logged.
+ *
+ * Keyed by path rather than held per instance because `child()` returns a new
+ * logger over the same file, and two independent `appendFile` calls to one path
+ * may complete in either order.
+ */
+const pendingByPath = new Map();
 /**
  * FileLogger - writes JSONL to a file, always at debug level.
  * Each line is a JSON object with timestamp, level, message, and context.
  */
-export class FileLogger {
-    level = 'debug';
+export class FileLogger extends JsonlLogger {
     filePath;
-    baseContext;
     fs;
     constructor(filePath, fs, baseContext = {}) {
+        super(baseContext);
         this.filePath = filePath;
         this.fs = fs;
-        this.baseContext = baseContext;
-    }
-    debug(message, context) {
-        this.log('debug', message, context);
-    }
-    info(message, context) {
-        this.log('info', message, context);
-    }
-    warn(message, context) {
-        this.log('warn', message, context);
-    }
-    error(message, error, context) {
-        const errorContext = error
-            ? {
-                ...context,
-                error: {
-                    name: error.name,
-                    message: error.message,
-                    stack: error.stack,
-                },
-            }
-            : context;
-        this.log('error', message, errorContext);
     }
     child(context) {
         return new FileLogger(this.filePath, this.fs, { ...this.baseContext, ...context });
     }
-    log(level, message, context) {
-        const entry = {
-            timestamp: new Date().toISOString(),
-            level,
-            message,
-            ...this.baseContext,
-            ...context,
-        };
-        const line = JSON.stringify(entry) + '\n';
-        this.fs.appendFile(this.filePath, line).catch(() => {
-            // Silently ignore write errors to avoid disrupting the application
+    writeLine(line) {
+        const path = this.filePath;
+        const previous = pendingByPath.get(path) ?? Promise.resolve();
+        // A failed append must not break the chain — the next line still has to be written.
+        const next = previous.then(() => this.fs.appendFile(path, line + '\n')).catch(() => { });
+        pendingByPath.set(path, next);
+        void next.then(() => {
+            if (pendingByPath.get(path) === next)
+                pendingByPath.delete(path);
         });
     }
 }
+/** Resolves once every line logged so far has been written. For tests and shutdown. */
+export function flushFileLogs(filePath) {
+    if (filePath !== undefined)
+        return pendingByPath.get(filePath) ?? Promise.resolve();
+    return Promise.all([...pendingByPath.values()]).then(() => undefined);
+}
 //# sourceMappingURL=file.js.map

package/dist/lib/logger/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/lib/logger/file.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAa,OAAO,CAAA;IAC1B,QAAQ,CAAQ;IAChB,WAAW,CAAY;IACvB,EAAE,CAAY;IAEtB,YAAY,QAAgB,EAAE,EAAc,EAAE,cAA0B,EAAE;QACzE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAoB;QAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAa,EAAE,OAAoB;QACzD,MAAM,YAAY,GAAG,KAAK;YACzB,CAAC,CAAC;gBACD,GAAG,OAAO;gBACV,KAAK,EAAE;oBACN,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBAClB;aACD;YACD,CAAC,CAAC,OAAO,CAAA;QAEV,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,OAAmB;QACxB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACnF,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAoB;QACjE,MAAM,KAAK,GAAG;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,WAAW;YACnB,GAAG,OAAO;SACV,CAAA;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;QACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAClD,mEAAmE;QACpE,CAAC,CAAC,CAAA;IACH,CAAC;CACD"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/lib/logger/file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEtD;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACb;IAAmC;IAAhE,YAA6B,QAAgB,EAAmB,EAAc,EAAE,cAA0B,EAAE;QAC3G,KAAK,CAAC,WAAW,CAAC,CAAA;QADU,aAAQ,GAAR,QAAQ,CAAQ;QAAmB,OAAE,GAAF,EAAE,CAAY;IAE9E,CAAC;IAED,KAAK,CAAC,OAAmB;QACxB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACnF,CAAC;IAES,SAAS,CAAC,IAAY;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC1B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QAC7D,oFAAoF;QACpF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACvF,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC7B,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI;gBAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACjE,CAAC,CAAC,CAAA;IACH,CAAC;CACD;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC9C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;IACnF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AACtE,CAAC"}

package/dist/lib/logger/index.d.ts

@@ -1,5 +1,7 @@
 export { ConsoleLogger, JsonLogger } from './console.js';
 export type { ConsoleLoggerConfig } from './console.js';
-export { FileLogger } from './file.js';
+export { FileLogger, flushFileLogs } from './file.js';
+export { JsonlLogger } from './jsonl.js';
+export { createSessionLogger, SessionLogStoreLogger } from './session-log.js';
 export { TeeLogger } from './tee.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/logger/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}

package/dist/lib/logger/index.js

@@ -1,4 +1,6 @@
 export { ConsoleLogger, JsonLogger } from './console.js';
-export { FileLogger } from './file.js';
+export { FileLogger, flushFileLogs } from './file.js';
+export { JsonlLogger } from './jsonl.js';
+export { createSessionLogger, SessionLogStoreLogger } from './session-log.js';
 export { TeeLogger } from './tee.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}

package/dist/lib/logger/jsonl.d.ts

@@ -0,0 +1,21 @@
+import type { LogContext, Logger, LogLevel } from './logger.js';
+import { BaseLogger } from './logger.js';
+/**
+ * One JSON object per entry, always at debug level.
+ *
+ * The level is deliberately not `config.logLevel`: the session log is the
+ * detailed record and the console logger is the filtered one.
+ *
+ * Shared by the file sink and the store sink so a host that moves the log into
+ * a table emits exactly the same entries — the sink is the only difference.
+ */
+export declare abstract class JsonlLogger extends BaseLogger {
+    protected readonly baseContext: LogContext;
+    readonly level: LogLevel;
+    constructor(baseContext?: LogContext);
+    abstract child(context: LogContext): Logger;
+    /** Takes one finished entry, no trailing newline. Must never throw. */
+    protected abstract writeLine(line: string): void;
+    protected log(level: LogLevel, message: string, context?: LogContext): void;
+}
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/lib/logger/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;GAQG;AACH,8BAAsB,WAAY,SAAQ,UAAU;IAGvC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU;IAFtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAU;gBAEH,WAAW,GAAE,UAAe;IAI3D,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAE3C,uEAAuE;IACvE,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAEhD,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAW3E"}

package/dist/lib/logger/jsonl.js

@@ -0,0 +1,29 @@
+import { BaseLogger } from './logger.js';
+/**
+ * One JSON object per entry, always at debug level.
+ *
+ * The level is deliberately not `config.logLevel`: the session log is the
+ * detailed record and the console logger is the filtered one.
+ *
+ * Shared by the file sink and the store sink so a host that moves the log into
+ * a table emits exactly the same entries — the sink is the only difference.
+ */
+export class JsonlLogger extends BaseLogger {
+    baseContext;
+    level = 'debug';
+    constructor(baseContext = {}) {
+        super();
+        this.baseContext = baseContext;
+    }
+    log(level, message, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...this.baseContext,
+            ...context,
+        };
+        this.writeLine(JSON.stringify(entry));
+    }
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/lib/logger/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/lib/logger/jsonl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;GAQG;AACH,MAAM,OAAgB,WAAY,SAAQ,UAAU;IAGpB;IAFtB,KAAK,GAAa,OAAO,CAAA;IAElC,YAA+B,cAA0B,EAAE;QAC1D,KAAK,EAAE,CAAA;QADuB,gBAAW,GAAX,WAAW,CAAiB;IAE3D,CAAC;IAOS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAoB;QACnE,MAAM,KAAK,GAAG;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,WAAW;YACnB,GAAG,OAAO;SACV,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IACtC,CAAC;CACD"}

package/dist/lib/logger/logger.d.ts

@@ -84,4 +84,26 @@ export interface ToolLogContext extends LogContext {
     toolCallId: string;
     durationMs?: number;
 }
+/**
+ * Shared base for sink-backed loggers.
+ *
+ * The four level methods and the Error->context flattening in error() were
+ * copied verbatim into ConsoleLogger, JsonLogger and FileLogger. The flattening
+ * is the part worth having in one place — it is the only path by which a stack
+ * trace reaches a structured log, so a sink that misses it drops the field
+ * silently.
+ *
+ * Subclasses supply only log() and child(); child() stays per-class because each
+ * returns its own type with its own config. TeeLogger does NOT extend this — it
+ * fans out to other loggers rather than writing to a sink.
+ */
+export declare abstract class BaseLogger implements Logger {
+    abstract readonly level: LogLevel;
+    protected abstract log(level: LogLevel, message: string, context?: LogContext): void;
+    abstract child(context: LogContext): Logger;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+}
 //# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAElD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;AAEpD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAO1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKvD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,cAAc,QAAQ,EAAE,iBAAiB,QAAQ,KAAG,OACN,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/logger.ts"],"names":[],"mappings":"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"}

package/dist/lib/logger/logger.js

@@ -25,4 +25,41 @@ export const LOG_LEVEL_PRIORITY = {
  * Helper pro porovnání log levels
  */
 export const shouldLog = (messageLevel, configuredLevel) => LOG_LEVEL_PRIORITY[messageLevel] >= LOG_LEVEL_PRIORITY[configuredLevel];
+/**
+ * Shared base for sink-backed loggers.
+ *
+ * The four level methods and the Error->context flattening in error() were
+ * copied verbatim into ConsoleLogger, JsonLogger and FileLogger. The flattening
+ * is the part worth having in one place — it is the only path by which a stack
+ * trace reaches a structured log, so a sink that misses it drops the field
+ * silently.
+ *
+ * Subclasses supply only log() and child(); child() stays per-class because each
+ * returns its own type with its own config. TeeLogger does NOT extend this — it
+ * fans out to other loggers rather than writing to a sink.
+ */
+export class BaseLogger {
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    error(message, error, context) {
+        const errorContext = error
+            ? {
+                ...context,
+                error: {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                },
+            }
+            : context;
+        this.log('error', message, errorContext);
+    }
+}
 //# sourceMappingURL=logger.js.map

package/dist/lib/logger/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/lib/logger/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqDH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IACnC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;IACzB,KAAK,EAAE,OAAO;CACd,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC3D,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACR,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,YAAsB,EAAE,eAAyB,EAAW,EAAE,CACvF,kBAAkB,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAA"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/lib/logger/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqDH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IACnC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;IACzB,KAAK,EAAE,OAAO;CACd,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC3D,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACR,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,YAAsB,EAAE,eAAyB,EAAW,EAAE,CACvF,kBAAkB,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAA;AAkCxE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,UAAU;IAO/B,KAAK,CAAC,OAAe,EAAE,OAAoB;QAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAa,EAAE,OAAoB;QACzD,MAAM,YAAY,GAAG,KAAK;YACzB,CAAC,CAAC;gBACD,GAAG,OAAO;gBACV,KAAK,EAAE;oBACN,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBAClB;aACD;YACD,CAAC,CAAC,OAAO,CAAA;QAEV,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IACzC,CAAC;CACD"}

package/dist/lib/logger/session-log.d.ts

@@ -0,0 +1,21 @@
+import type { Platform } from '../../platform/index.js';
+import type { SessionLogStore } from '../../platform/session-log.js';
+import { JsonlLogger } from './jsonl.js';
+import type { LogContext, Logger } from './logger.js';
+/** The same JSONL FileLogger writes, into a {@link SessionLogStore} row. */
+export declare class SessionLogStoreLogger extends JsonlLogger {
+    private readonly store;
+    private readonly sessionId;
+    constructor(store: SessionLogStore, sessionId: string, baseContext?: LogContext);
+    child(context: LogContext): Logger;
+    protected writeLine(line: string): void;
+}
+/**
+ * The session's own log sink: rows where the host has a table for them, the
+ * `session.log` file everywhere else.
+ *
+ * The absence of `platform.sessionLog` is the status quo — same file, same
+ * bytes, same byte-offset cursor in `logs.tail`.
+ */
+export declare function createSessionLogger(platform: Pick<Platform, 'fs' | 'sessionLog'>, sessionId: string, logPath: string): Logger;
+//# sourceMappingURL=session-log.d.ts.map

package/dist/lib/logger/session-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.d.ts","sourceRoot":"","sources":["../../../src/lib/logger/session-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAErD,4EAA4E;AAC5E,qBAAa,qBAAsB,SAAQ,WAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAmB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAlD,KAAK,EAAE,eAAe,EAAmB,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,UAAe;IAIrH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAIlC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAOvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,YAAY,CAAC,EAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,MAAM,CAKR"}

package/dist/lib/logger/session-log.js

@@ -0,0 +1,37 @@
+import { FileLogger } from './file.js';
+import { JsonlLogger } from './jsonl.js';
+/** The same JSONL FileLogger writes, into a {@link SessionLogStore} row. */
+export class SessionLogStoreLogger extends JsonlLogger {
+    store;
+    sessionId;
+    constructor(store, sessionId, baseContext = {}) {
+        super(baseContext);
+        this.store = store;
+        this.sessionId = sessionId;
+    }
+    child(context) {
+        return new SessionLogStoreLogger(this.store, this.sessionId, { ...this.baseContext, ...context });
+    }
+    writeLine(line) {
+        try {
+            this.store.append(this.sessionId, line);
+        }
+        catch {
+            // Dropped exactly as a failed file append is — nothing on the agent loop awaits this.
+        }
+    }
+}
+/**
+ * The session's own log sink: rows where the host has a table for them, the
+ * `session.log` file everywhere else.
+ *
+ * The absence of `platform.sessionLog` is the status quo — same file, same
+ * bytes, same byte-offset cursor in `logs.tail`.
+ */
+export function createSessionLogger(platform, sessionId, logPath) {
+    const store = platform.sessionLog;
+    return store === undefined
+        ? new FileLogger(logPath, platform.fs, { sessionId })
+        : new SessionLogStoreLogger(store, sessionId, { sessionId });
+}
+//# sourceMappingURL=session-log.js.map

package/dist/lib/logger/session-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.js","sourceRoot":"","sources":["../../../src/lib/logger/session-log.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,4EAA4E;AAC5E,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACxB;IAAyC;IAAtE,YAA6B,KAAsB,EAAmB,SAAiB,EAAE,cAA0B,EAAE;QACpH,KAAK,CAAC,WAAW,CAAC,CAAA;QADU,UAAK,GAAL,KAAK,CAAiB;QAAmB,cAAS,GAAT,SAAS,CAAQ;IAEvF,CAAC;IAED,KAAK,CAAC,OAAmB;QACxB,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IAClG,CAAC;IAES,SAAS,CAAC,IAAY;QAC/B,IAAI,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACR,sFAAsF;QACvF,CAAC;IACF,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAA6C,EAC7C,SAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAA;IACjC,OAAO,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;QACrD,CAAC,CAAC,IAAI,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;AAC9D,CAAC"}

package/dist/lib/utils/concurrency.d.ts

@@ -18,7 +18,7 @@ export declare class Semaphore {
     private active;
     private readonly waiters;
     constructor(limit: number);
-    run<T>(fn: () => Promise<T>): Promise<T>;
+    run<T>(fn: () => Promise<T>, signal?: AbortSignal): Promise<T>;
     private acquire;
     private release;
 }

package/dist/lib/utils/concurrency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC5C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,EAAE,CAAC,CAad;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IAIT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEnB,KAAK,EAAE,MAAM;IAMpC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS9C,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;CASf"}
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC5C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,EAAE,CAAC,CAad;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IAQT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPlC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAIjB;gBAEsB,KAAK,EAAE,MAAM;IAMpC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAYpE,OAAO,CAAC,OAAO;IA6Bf,OAAO,CAAC,OAAO;CAYf"}

package/dist/lib/utils/concurrency.js

@@ -37,29 +37,52 @@ export class Semaphore {
             throw new Error(`Semaphore limit must be a positive integer, got ${limit}`);
         }
     }
-    async run(fn) {
-        await this.acquire();
+    async run(fn, signal) {
+        let acquired = false;
         try {
+            await this.acquire(signal);
+            acquired = true;
+            signal?.throwIfAborted();
             return await fn();
         }
         finally {
-            this.release();
+            if (acquired)
+                this.release();
         }
     }
-    acquire() {
+    acquire(signal) {
+        if (signal?.aborted) {
+            return Promise.reject(signal.reason);
+        }
         if (this.active < this.limit) {
             this.active++;
             return Promise.resolve();
         }
-        return new Promise(resolve => {
-            this.waiters.push(resolve);
+        return new Promise((resolve, reject) => {
+            const waiter = { resolve, signal };
+            if (signal) {
+                const onAbort = () => {
+                    const index = this.waiters.indexOf(waiter);
+                    if (index === -1)
+                        return;
+                    this.waiters.splice(index, 1);
+                    signal.removeEventListener('abort', onAbort);
+                    reject(signal.reason);
+                };
+                waiter.onAbort = onAbort;
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+            this.waiters.push(waiter);
         });
     }
     release() {
         const next = this.waiters.shift();
         if (next) {
             // Slot transfers directly to the next waiter; active stays unchanged.
-            next();
+            if (next.signal && next.onAbort) {
+                next.signal.removeEventListener('abort', next.onAbort);
+            }
+            next.resolve();
         }
         else {
             this.active--;

package/dist/lib/utils/concurrency.js.map

@@ -1 +1 @@
-{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../../src/lib/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAmB,EACnB,WAAmB,EACnB,EAA0C;IAE1C,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5C,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,EAAE;QAC9D,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,IAAI,EAAE,CAAA;YAChB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAM;YAC7B,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,CAAC,CAAC,CAAA;QACxC,CAAC;IACF,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC1B,OAAO,OAAO,CAAA;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IAIQ;IAHrB,MAAM,GAAG,CAAC,CAAA;IACD,OAAO,GAAsB,EAAE,CAAA;IAEhD,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,EAAE,CAAC,CAAA;QAC5E,CAAC;IACF,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,EAAoB;QAChC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACpB,IAAI,CAAC;YACJ,OAAO,MAAM,EAAE,EAAE,CAAA;QAClB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,OAAO,EAAE,CAAA;QACf,CAAC;IACF,CAAC;IAEO,OAAO;QACd,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,EAAE,CAAA;YACb,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QACzB,CAAC;QACD,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACH,CAAC;IAEO,OAAO;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACjC,IAAI,IAAI,EAAE,CAAC;YACV,sEAAsE;YACtE,IAAI,EAAE,CAAA;QACP,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,MAAM,EAAE,CAAA;QACd,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../../src/lib/utils/concurrency.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/fs-batch.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Reading a known set of files, however the platform prefers to be asked.
+ *
+ * `FileSystem.readFiles` is optional — a plain node:fs platform has no use for
+ * it, a database-backed one answers a whole set in about the work it spends on
+ * one file. Every caller with a list of paths wants the same two things from
+ * that difference: the batch where it exists, and the loop where it does not,
+ * with a missing file reported rather than thrown either way.
+ *
+ * So it lives here once instead of at each call site.
+ */
+import type { FileSystem } from '../../platform/fs.js';
+/** Every path's bytes, in order, `undefined` where there was nothing to read. */
+export declare function readFilesOrUndefined(fs: FileSystem, paths: readonly string[]): Promise<(Buffer | undefined)[]>;
+/** The same, decoded as UTF-8. */
+export declare function readTextFilesOrUndefined(fs: FileSystem, paths: readonly string[]): Promise<(string | undefined)[]>;
+//# sourceMappingURL=fs-batch.d.ts.map

package/dist/lib/utils/fs-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-batch.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/fs-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAMlD,iFAAiF;AACjF,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,UAAU,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CASjC;AAED,kCAAkC;AAClC,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,UAAU,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAGjC"}

package/dist/lib/utils/fs-batch.js

@@ -0,0 +1,38 @@
+/**
+ * Reading a known set of files, however the platform prefers to be asked.
+ *
+ * `FileSystem.readFiles` is optional — a plain node:fs platform has no use for
+ * it, a database-backed one answers a whole set in about the work it spends on
+ * one file. Every caller with a list of paths wants the same two things from
+ * that difference: the batch where it exists, and the loop where it does not,
+ * with a missing file reported rather than thrown either way.
+ *
+ * So it lives here once instead of at each call site.
+ */
+import { mapWithConcurrency } from './concurrency.js';
+/** Files read at once when the platform has no batch verb. */
+const READ_CONCURRENCY = 16;
+/** Every path's bytes, in order, `undefined` where there was nothing to read. */
+export async function readFilesOrUndefined(fs, paths) {
+    if (paths.length === 0)
+        return [];
+    if (fs.readFiles) {
+        const read = await fs.readFiles(paths);
+        return paths.map((_path, index) => read[index]?.content);
+    }
+    return mapWithConcurrency(paths, READ_CONCURRENCY, (path) => readOrUndefined(fs, path));
+}
+/** The same, decoded as UTF-8. */
+export async function readTextFilesOrUndefined(fs, paths) {
+    const read = await readFilesOrUndefined(fs, paths);
+    return read.map((bytes) => bytes?.toString('utf-8'));
+}
+async function readOrUndefined(fs, path) {
+    try {
+        return await fs.readFile(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=fs-batch.js.map

package/dist/lib/utils/fs-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-batch.js","sourceRoot":"","sources":["../../../src/lib/utils/fs-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,8DAA8D;AAC9D,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAE3B,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,EAAc,EACd,KAAwB;IAExB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACtC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;AACxF,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,EAAc,EACd,KAAwB;IAExB,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;AACrD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,EAAc,EAAE,IAAY;IAC1D,IAAI,CAAC;QACJ,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAA;IACjB,CAAC;AACF,CAAC"}

package/dist/lib/utils/result.d.ts

@@ -1,26 +1,11 @@
 /**
  * Result type for explicit error handling without exceptions.
- * Inspired by Rust/Go approach.
+ *
+ * Re-exported from @roj-ai/transport, which owns the definition — sdk already
+ * depends on it, and three byte-identical copies (here, transport, shared) meant
+ * any addition to the vocabulary had to be written three times or silently
+ * diverge. The ~58 in-package importers keep using `~/lib/utils/result.js`.
  */
-export type Result<T, E = Error> = {
-    ok: true;
-    value: T;
-} | {
-    ok: false;
-    error: E;
-};
-export declare const Ok: <T>(value: T) => Result<T, never>;
-export declare const Err: <E>(error: E) => Result<never, E>;
-export declare const isOk: <T, E>(result: Result<T, E>) => result is {
-    ok: true;
-    value: T;
-};
-export declare const isErr: <T, E>(result: Result<T, E>) => result is {
-    ok: false;
-    error: E;
-};
-export declare const mapResult: <T, U, E>(result: Result<T, E>, fn: (value: T) => U) => Result<U, E>;
-export declare const flatMapResult: <T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>) => Result<U, E>;
-export declare const unwrapOr: <T, E>(result: Result<T, E>, defaultValue: T) => T;
-export declare const unwrapOrThrow: <T, E>(result: Result<T, E>) => T;
+export type { Result } from '@roj-ai/transport';
+export { Err, flatMapResult, isErr, isOk, mapResult, Ok, unwrapOr, unwrapOrThrow } from '@roj-ai/transport';
 //# sourceMappingURL=result.d.ts.map

package/dist/lib/utils/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAG1B,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAA0B,CAAA;AAC1E,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAA2B,CAAA;AAG5E,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAe,CAAA;AAC/F,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAgB,CAAA;AAGlG,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KACjB,MAAM,CAAC,CAAC,EAAE,CAAC,CAA8C,CAAA;AAE5D,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EACpC,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAC5B,MAAM,CAAC,CAAC,EAAE,CAAC,CAA0C,CAAA;AAGxD,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,KAAG,CAA4C,CAAA;AAEnH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAG1D,CAAA"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/lib/utils/result.js

@@ -1,21 +1,10 @@
 /**
  * Result type for explicit error handling without exceptions.
- * Inspired by Rust/Go approach.
+ *
+ * Re-exported from @roj-ai/transport, which owns the definition — sdk already
+ * depends on it, and three byte-identical copies (here, transport, shared) meant
+ * any addition to the vocabulary had to be written three times or silently
+ * diverge. The ~58 in-package importers keep using `~/lib/utils/result.js`.
  */
-// Constructors
-export const Ok = (value) => ({ ok: true, value });
-export const Err = (error) => ({ ok: false, error });
-// Type guards
-export const isOk = (result) => result.ok;
-export const isErr = (result) => !result.ok;
-// Helper functions
-export const mapResult = (result, fn) => result.ok ? Ok(fn(result.value)) : result;
-export const flatMapResult = (result, fn) => result.ok ? fn(result.value) : result;
-// Unwrap functions
-export const unwrapOr = (result, defaultValue) => result.ok ? result.value : defaultValue;
-export const unwrapOrThrow = (result) => {
-    if (result.ok)
-        return result.value;
-    throw result.error;
-};
+export { Err, flatMapResult, isErr, isOk, mapResult, Ok, unwrapOr, unwrapOrThrow } from '@roj-ai/transport';
 //# sourceMappingURL=result.js.map

package/dist/lib/utils/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/utils/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,eAAe;AACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AAC1E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;AAE5E,cAAc;AACd,MAAM,CAAC,MAAM,IAAI,GAAG,CAAO,MAAoB,EAAoC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAA;AAC/F,MAAM,CAAC,MAAM,KAAK,GAAG,CAAO,MAAoB,EAAqC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAA;AAElG,mBAAmB;AACnB,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,MAAoB,EACpB,EAAmB,EACJ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAC5B,MAAoB,EACpB,EAA8B,EACf,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AAExD,mBAAmB;AACnB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAO,MAAoB,EAAE,YAAe,EAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;AAEnH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAO,MAAoB,EAAK,EAAE;IAC9D,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAA;IAClC,MAAM,MAAM,CAAC,KAAK,CAAA;AACnB,CAAC,CAAA"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/utils/result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/lib/utils/sleep.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cancellable sleep.
+ *
+ * Resolves early (rather than rejecting) when `signal` aborts, so a retry or
+ * poll loop can check its own abort condition and exit on the next iteration.
+ * Prefer this over a bare `setTimeout` promise anywhere inside such a loop —
+ * a non-cancellable wait is what makes shutdown take as long as the backoff.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/lib/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrE"}

package/dist/lib/utils/sleep.js

@@ -0,0 +1,26 @@
+/**
+ * Cancellable sleep.
+ *
+ * Resolves early (rather than rejecting) when `signal` aborts, so a retry or
+ * poll loop can check its own abort condition and exit on the next iteration.
+ * Prefer this over a bare `setTimeout` promise anywhere inside such a loop —
+ * a non-cancellable wait is what makes shutdown take as long as the backoff.
+ */
+export function sleep(ms, signal) {
+    if (signal?.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', finish);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        signal?.addEventListener('abort', finish, { once: true });
+    });
+}
+//# sourceMappingURL=sleep.js.map