@avi770/testteam 2.0.0 → 3.2.0

package/dist/core/report-upload.js

@@ -5,11 +5,14 @@ import { createRequire } from 'node:module';
  * Dynamically load an optional npm package at runtime.
  * Uses createRequire to avoid TypeScript static module resolution errors.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 async function optionalRequire(packageName) {
     const require = createRequire(import.meta.url);
     return require(packageName);
 }
+/** Default per-request upload timeout (P1-5): stalls must not hang the pipeline. */
+const DEFAULT_UPLOAD_TIMEOUT_MS = 120_000;
+/** TCP connect timeout for cloud uploads. */
+const CONNECT_TIMEOUT_MS = 10_000;
 function generateReportFilename(originalPath) {
     const base = basename(originalPath, '.html');
     const ts = new Date().toISOString().replace(/[:.]/g, '-');
@@ -32,7 +35,6 @@ async function uploadLocal(htmlPath, config) {
     };
 }
 async function uploadS3(htmlPath, config) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let sdk;
     try {
         sdk = await optionalRequire('@aws-sdk/client-s3');
@@ -47,8 +49,14 @@ async function uploadS3(htmlPath, config) {
     const filename = generateReportFilename(htmlPath);
     const key = `${prefix}${filename}`;
     const body = await readFile(htmlPath);
+    // P1-5: the AWS SDK v3 default is NO socket timeout — bound both the TCP
+    // connect and the request so a network stall cannot hang the pipeline.
     const client = new sdk.S3Client({
         region: config.region ?? 'us-east-1',
+        requestHandler: {
+            requestTimeout: config.timeoutMs ?? DEFAULT_UPLOAD_TIMEOUT_MS,
+            connectionTimeout: CONNECT_TIMEOUT_MS,
+        },
     });
     await client.send(new sdk.PutObjectCommand({
         Bucket: config.bucket,
@@ -66,7 +74,6 @@ async function uploadS3(htmlPath, config) {
     };
 }
 async function uploadAzureBlob(htmlPath, config) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let sdk;
     try {
         sdk = await optionalRequire('@azure/storage-blob');
@@ -86,10 +93,16 @@ async function uploadAzureBlob(htmlPath, config) {
     const body = await readFile(htmlPath);
     const blobServiceClient = sdk.BlobServiceClient.fromConnectionString(config.connectionString);
     const containerClient = blobServiceClient.getContainerClient(config.bucket);
-    await containerClient.createIfNotExists({ access: 'blob' });
+    // P1-5: bound every network call so a stall cannot hang the pipeline.
+    const abortSignal = AbortSignal.timeout(config.timeoutMs ?? DEFAULT_UPLOAD_TIMEOUT_MS);
+    // P1-4: containers are PRIVATE by default. `access: 'blob'` grants anonymous
+    // public READ on every uploaded report — screenshots/logs can contain secrets
+    // or PII, so that exposure requires the explicit `publicAccess: true` opt-in.
+    await containerClient.createIfNotExists(config.publicAccess ? { access: 'blob', abortSignal } : { abortSignal });
     const blockBlobClient = containerClient.getBlockBlobClient(blobName);
     await blockBlobClient.upload(body, body.byteLength, {
         blobHTTPHeaders: { blobContentType: 'text/html' },
+        abortSignal,
     });
     return {
         url: blockBlobClient.url,

package/dist/core/report-upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-upload.js","sourceRoot":"","sources":["../../core/report-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,8DAA8D;AAC9D,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAwB,CAAC;AACrD,CAAC;AAiBD,SAAS,sBAAsB,CAAC,YAAoB;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,IAAI,IAAI,EAAE,OAAO,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,QAAgB,EAChB,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,mBAAmB,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,OAAO;QACL,GAAG,EAAE,UAAU,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE;QACjD,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,QAAgB,EAChB,MAAoB;IAEpB,8DAA8D;IAC9D,IAAI,GAAwB,CAAC;IAE7B,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,eAAe,CAAC,oBAAoB,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,mBAAmB,CAAC;IACpD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;IAEnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,WAAW;KACrC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,GAAG,CAAC,gBAAgB,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW;KACzB,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC;IAC5C,MAAM,GAAG,GAAG,WAAW,MAAM,CAAC,MAAM,OAAO,MAAM,kBAAkB,GAAG,EAAE,CAAC;IAEzE,OAAO;QACL,GAAG;QACH,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAgB,EAChB,MAAoB;IAEpB,8DAA8D;IAC9D,IAAI,GAAwB,CAAC;IAE7B,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,eAAe,CAAC,qBAAqB,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,mBAAmB,CAAC;IACpD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;IAExC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC,oBAAoB,CAClE,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACF,MAAM,eAAe,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,eAAe,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5D,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE;QAClD,eAAe,EAAE,EAAE,eAAe,EAAE,WAAW,EAAE;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,EAAE,eAAe,CAAC,GAAG;QACxB,QAAQ,EAAE,YAAY;QACtB,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,MAAoB;IAEpB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,8CAA8C;IAC9C,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAEzB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,IAAI;YACP,OAAO,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC,QAAQ,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,mBAAmB;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"report-upload.js","sourceRoot":"","sources":["../../core/report-upload.ts"],"names":[],"mappings":"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"}

package/dist/core/run-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-counter.d.ts","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wFAAwF;AACxF,iBAAS,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE1C;AAED,iGAAiG;AACjG,iBAAS,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASxC;AAmCD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAgCjE;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,IAAI,CAaN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,aAAa,CAQf;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGvD;AAUD,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,YAAY,IAAI,aAAa,EAAE,CAAC"}
+{"version":3,"file":"run-counter.d.ts","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wFAAwF;AACxF,iBAAS,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE1C;AAED,iGAAiG;AACjG,iBAAS,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASxC;AAmCD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAgCjE;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,IAAI,CAaN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,aAAa,CAQf;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGvD;AAgCD,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,YAAY,IAAI,aAAa,EAAE,CAAC"}

package/dist/core/run-counter.js

@@ -113,7 +113,31 @@ export function resetRunCounter(configDir) {
 // ── Internal helpers ────────────────────────────────────────────────
 function saveRunCounter(configDir, state) {
     const filePath = getRunCounterPath(configDir);
-    fs.writeFileSync(filePath, JSON.stringify(state, null, 2), 'utf8');
+    // Atomic write (P1-2): write to a sibling temp file, then rename over the live
+    // path. A crash mid-write on a direct writeFileSync leaves invalid JSON, which
+    // loadRunCounter "heals" by RESETTING the count — i.e. a quota reset. rename on
+    // the same volume is atomic on POSIX and effectively so on NTFS. Concurrent
+    // writers remain last-writer-wins (single-machine CLI; accepted, see
+    // docs/hardening/DECISIONS.md).
+    const serialised = JSON.stringify(state, null, 2);
+    const tempPath = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tempPath, serialised, 'utf8');
+    try {
+        fs.renameSync(tempPath, filePath);
+    }
+    catch {
+        // Windows can refuse rename-over-open-file. Fall back to a direct write so
+        // the run is still recorded — the residual corruption window here is strictly
+        // smaller than the pre-atomic behaviour and only in this rare locked-file
+        // case. Always clean up the temp file, even if the direct write itself throws
+        // (e.g. EACCES), so no orphaned `.tmp` is left behind.
+        try {
+            fs.writeFileSync(filePath, serialised, 'utf8');
+        }
+        finally {
+            fs.rmSync(tempPath, { force: true });
+        }
+    }
 }
 // Exported for testing only
 export { periodStartFor as _periodStartFor, periodEndFor as _periodEndFor };

package/dist/core/run-counter.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-counter.js","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-counter.js","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAwBlC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEnD,wEAAwE;AAExE,wFAAwF;AACxF,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,iGAAiG;AACjG,SAAS,YAAY,CAAC,IAAU;IAC9B,mDAAmD;IACnD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,IAAI,CAAC,GAAG,CACb,OAAO,CAAC,cAAc,EAAE,EACxB,OAAO,CAAC,WAAW,EAAE,EACrB,OAAO,CAAC,UAAU,EAAE,EACpB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAS;IACjC,OAAO;QACL,WAAW,EAAE,cAAc,CAAC,GAAG,CAAC;QAChC,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;QAC5B,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;KACb,CAAC;AACJ,CAAC;AAED,uEAAuE;AAEvE,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,IAAI,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9C,OAAQ,GAAG,CAAC,MAAM,CAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,OAAO,CACL,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ;YACpC,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ;YAChC,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,CACtC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACpC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAEnE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACpC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wCAAwC;QACxC,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACpC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACpC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,KAAa,EACb,UAAkB;IAElB,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAExC,MAAM,MAAM,GAAc;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;QACL,UAAU;KACX,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IAEpC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,IAAI,OAAO,GAAG,GAAG,CAAC;IAEtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,uEAAuE;AAEvE,SAAS,cAAc,CAAC,SAAiB,EAAE,KAAsB;IAC/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,+EAA+E;IAC/E,+EAA+E;IAC/E,gFAAgF;IAChF,4EAA4E;IAC5E,qEAAqE;IACrE,gCAAgC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,8EAA8E;QAC9E,0EAA0E;QAC1E,8EAA8E;QAC9E,uDAAuD;QACvD,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,YAAY,IAAI,aAAa,EAAE,CAAC"}

package/dist/core/run-events/emitter.d.ts

@@ -0,0 +1,112 @@
+/**
+ * RunEventEmitter — stamps a monotonic seq + injected-clock timestamp on each run event,
+ * keeps a bounded in-memory log (replayable), and fans out to a sink. A throwing sink can
+ * NEVER break the run (fail-safe): emission is wrapped in try/catch. Default sink is a no-op,
+ * so an orchestrator constructed without a sink behaves exactly as before and costs nothing.
+ *
+ * Mirrors the event-sourced discipline of core/loop-engine (state is a pure fold over the log).
+ */
+import type { RunEvent, RunEventSink, RunStateView } from './types.js';
+import type { Phase, AgentStatus, FindingSeverity } from '../types.js';
+/** Discards every event. The default — keeps the orchestrator seam zero-cost when unobserved. */
+export declare class NoopRunEventSink implements RunEventSink {
+    emit(): void;
+}
+/** Collects events in arrival order. For tests and short-lived buffering. */
+export declare class InMemoryRunEventSink implements RunEventSink {
+    private readonly _events;
+    emit(event: RunEvent): void;
+    get events(): readonly RunEvent[];
+}
+/** Broadcasts to many sinks; one throwing sink does not stop the others (isolation). */
+export declare class FanOutRunEventSink implements RunEventSink {
+    private readonly sinks;
+    constructor(sinks: readonly RunEventSink[]);
+    emit(event: RunEvent): void;
+}
+export interface RunEventEmitterOptions {
+    /** Injectable clock for deterministic tests. Defaults to Date.now. */
+    readonly clock?: () => number;
+    /** Bound on the in-memory replay log (oldest dropped past this). Defaults to 10_000. */
+    readonly maxLog?: number;
+}
+export declare class RunEventEmitter {
+    private seq;
+    private readonly log;
+    private readonly sink;
+    private readonly clock;
+    private readonly maxLog;
+    constructor(sink?: RunEventSink, options?: RunEventEmitterOptions);
+    runStarted(p: {
+        runId: string;
+        phase: Phase;
+        scheduledAgentIds: readonly number[];
+    }): void;
+    phaseStarted(p: {
+        phase: Phase;
+        totalAgents: number;
+    }): void;
+    agentStarted(p: {
+        phase: Phase;
+        agentId: number;
+        agentName: string;
+    }): void;
+    agentFinished(p: {
+        phase: Phase;
+        agentId: number;
+        agentName: string;
+        status: AgentStatus;
+        durationMs: number;
+        findingsCount: number;
+        worstSeverity: FindingSeverity | null;
+    }): void;
+    agentSkipped(p: {
+        phase: Phase;
+        agentId: number;
+        agentName: string;
+        reason: 'disabled' | 'unregistered' | 'license-gated';
+    }): void;
+    budgetExceeded(p: {
+        phase: Phase;
+        totalCost: number;
+    }): void;
+    gateEvaluated(p: {
+        phase: Phase;
+        passed: boolean;
+        failedBlockingAgents: readonly number[];
+    }): void;
+    phaseFinished(p: {
+        phase: Phase;
+        passed: boolean;
+        agentCount: number;
+        skippedCount: number;
+    }): void;
+    runFinished(p: {
+        runId: string;
+        passed: boolean;
+    }): void;
+    questionAsked(p: {
+        questionId: string;
+        agentId: number;
+        title: string;
+        detail: string;
+        proposedAction?: string;
+    }): void;
+    questionAnswered(p: {
+        questionId: string;
+        decision: 'approve' | 'reject' | 'modify';
+        note?: string;
+    }): void;
+    /** A defensive copy of the replay log. */
+    get events(): readonly RunEvent[];
+    /** The current folded view (pure fold over the log). */
+    state(): RunStateView;
+    private push;
+}
+/**
+ * Fold a run-event stream into the live Cockpit view. Pure — same events always yield the
+ * same view (replayable). Later events for an agent supersede earlier ones (last-writer-wins
+ * per agent), so running > pending and finished > running naturally.
+ */
+export declare function foldRunState(events: readonly RunEvent[]): RunStateView;
+//# sourceMappingURL=emitter.d.ts.map

package/dist/core/run-events/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../core/run-events/emitter.ts"],"names":[],"mappings":"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"}

package/dist/core/run-events/emitter.js

@@ -0,0 +1,234 @@
+/**
+ * RunEventEmitter — stamps a monotonic seq + injected-clock timestamp on each run event,
+ * keeps a bounded in-memory log (replayable), and fans out to a sink. A throwing sink can
+ * NEVER break the run (fail-safe): emission is wrapped in try/catch. Default sink is a no-op,
+ * so an orchestrator constructed without a sink behaves exactly as before and costs nothing.
+ *
+ * Mirrors the event-sourced discipline of core/loop-engine (state is a pure fold over the log).
+ */
+/** Discards every event. The default — keeps the orchestrator seam zero-cost when unobserved. */
+export class NoopRunEventSink {
+    emit() {
+        /* intentionally empty */
+    }
+}
+/** Collects events in arrival order. For tests and short-lived buffering. */
+export class InMemoryRunEventSink {
+    _events = [];
+    emit(event) {
+        this._events.push(event);
+    }
+    get events() {
+        return this._events.slice();
+    }
+}
+/** Broadcasts to many sinks; one throwing sink does not stop the others (isolation). */
+export class FanOutRunEventSink {
+    sinks;
+    constructor(sinks) {
+        this.sinks = sinks.slice();
+    }
+    emit(event) {
+        for (const sink of this.sinks) {
+            try {
+                sink.emit(event);
+            }
+            catch {
+                /* isolate a faulty sink — siblings and the run must continue */
+            }
+        }
+    }
+}
+const DEFAULT_MAX_LOG = 10_000;
+export class RunEventEmitter {
+    seq = 0;
+    log = [];
+    sink;
+    clock;
+    maxLog;
+    constructor(sink = new NoopRunEventSink(), options) {
+        this.sink = sink;
+        this.clock = options?.clock ?? (() => Date.now());
+        this.maxLog = options?.maxLog !== undefined && options.maxLog > 0 ? options.maxLog : DEFAULT_MAX_LOG;
+    }
+    runStarted(p) {
+        this.push({ kind: 'run-started', seq: this.seq++, atMs: this.clock(), runId: p.runId, phase: p.phase, scheduledAgentIds: p.scheduledAgentIds.slice() });
+    }
+    phaseStarted(p) {
+        this.push({ kind: 'phase-started', seq: this.seq++, atMs: this.clock(), phase: p.phase, totalAgents: p.totalAgents });
+    }
+    agentStarted(p) {
+        this.push({ kind: 'agent-started', seq: this.seq++, atMs: this.clock(), phase: p.phase, agentId: p.agentId, agentName: p.agentName });
+    }
+    agentFinished(p) {
+        this.push({
+            kind: 'agent-finished',
+            seq: this.seq++,
+            atMs: this.clock(),
+            phase: p.phase,
+            agentId: p.agentId,
+            agentName: p.agentName,
+            status: p.status,
+            durationMs: p.durationMs,
+            findingsCount: p.findingsCount,
+            worstSeverity: p.worstSeverity,
+        });
+    }
+    agentSkipped(p) {
+        this.push({ kind: 'agent-skipped', seq: this.seq++, atMs: this.clock(), phase: p.phase, agentId: p.agentId, agentName: p.agentName, reason: p.reason });
+    }
+    budgetExceeded(p) {
+        this.push({ kind: 'budget-exceeded', seq: this.seq++, atMs: this.clock(), phase: p.phase, totalCost: p.totalCost });
+    }
+    gateEvaluated(p) {
+        this.push({ kind: 'gate-evaluated', seq: this.seq++, atMs: this.clock(), phase: p.phase, passed: p.passed, failedBlockingAgents: p.failedBlockingAgents.slice() });
+    }
+    phaseFinished(p) {
+        this.push({ kind: 'phase-finished', seq: this.seq++, atMs: this.clock(), phase: p.phase, passed: p.passed, agentCount: p.agentCount, skippedCount: p.skippedCount });
+    }
+    runFinished(p) {
+        this.push({ kind: 'run-finished', seq: this.seq++, atMs: this.clock(), runId: p.runId, passed: p.passed });
+    }
+    questionAsked(p) {
+        this.push({
+            kind: 'question-asked',
+            seq: this.seq++,
+            atMs: this.clock(),
+            questionId: p.questionId,
+            agentId: p.agentId,
+            title: p.title,
+            detail: p.detail,
+            ...(p.proposedAction !== undefined ? { proposedAction: p.proposedAction } : {}),
+        });
+    }
+    questionAnswered(p) {
+        this.push({
+            kind: 'question-answered',
+            seq: this.seq++,
+            atMs: this.clock(),
+            questionId: p.questionId,
+            decision: p.decision,
+            ...(p.note !== undefined ? { note: p.note } : {}),
+        });
+    }
+    /** A defensive copy of the replay log. */
+    get events() {
+        return this.log.slice();
+    }
+    /** The current folded view (pure fold over the log). */
+    state() {
+        return foldRunState(this.log);
+    }
+    push(event) {
+        this.log.push(event);
+        if (this.log.length > this.maxLog) {
+            this.log.shift();
+        }
+        try {
+            this.sink.emit(event);
+        }
+        catch {
+            /* fail-safe: a throwing sink must never break a pipeline run */
+        }
+    }
+}
+/**
+ * Fold a run-event stream into the live Cockpit view. Pure — same events always yield the
+ * same view (replayable). Later events for an agent supersede earlier ones (last-writer-wins
+ * per agent), so running > pending and finished > running naturally.
+ */
+export function foldRunState(events) {
+    const view = {
+        runId: null,
+        phase: null,
+        phaseActive: false,
+        agents: {},
+        gate: null,
+        budgetExceeded: false,
+        finished: false,
+        pendingQuestions: {},
+        lastSeq: -1,
+    };
+    for (const e of events) {
+        view.lastSeq = e.seq;
+        switch (e.kind) {
+            case 'run-started': {
+                view.runId = e.runId;
+                view.phase = e.phase;
+                for (const id of e.scheduledAgentIds) {
+                    if (view.agents[id] === undefined) {
+                        view.agents[id] = { agentId: id, agentName: `agent-${id}`, status: 'pending' };
+                    }
+                }
+                break;
+            }
+            case 'phase-started': {
+                view.phase = e.phase;
+                view.phaseActive = true;
+                break;
+            }
+            case 'agent-started': {
+                view.agents[e.agentId] = { agentId: e.agentId, agentName: e.agentName, status: 'running' };
+                break;
+            }
+            case 'agent-finished': {
+                const row = {
+                    agentId: e.agentId,
+                    agentName: e.agentName,
+                    status: e.status,
+                    durationMs: e.durationMs,
+                    findingsCount: e.findingsCount,
+                    worstSeverity: e.worstSeverity,
+                };
+                view.agents[e.agentId] = row;
+                break;
+            }
+            case 'agent-skipped': {
+                view.agents[e.agentId] = { agentId: e.agentId, agentName: e.agentName, status: 'skipped', skipReason: e.reason };
+                break;
+            }
+            case 'budget-exceeded': {
+                view.budgetExceeded = true;
+                break;
+            }
+            case 'gate-evaluated': {
+                view.gate = { evaluated: true, passed: e.passed, failedBlockingAgents: e.failedBlockingAgents };
+                break;
+            }
+            case 'phase-finished': {
+                view.phaseActive = false;
+                break;
+            }
+            case 'run-finished': {
+                view.finished = true;
+                break;
+            }
+            case 'question-asked': {
+                view.pendingQuestions = {
+                    ...view.pendingQuestions,
+                    [e.questionId]: {
+                        questionId: e.questionId,
+                        agentId: e.agentId,
+                        title: e.title,
+                        detail: e.detail,
+                        askedAtMs: e.atMs,
+                        ...(e.proposedAction !== undefined ? { proposedAction: e.proposedAction } : {}),
+                    },
+                };
+                break;
+            }
+            case 'question-answered': {
+                const { [e.questionId]: _answered, ...rest } = view.pendingQuestions;
+                view.pendingQuestions = rest;
+                break;
+            }
+            default: {
+                // Exhaustiveness guard: if a new RunEvent kind is added, TS errors here.
+                const _never = e;
+                return _never;
+            }
+        }
+    }
+    return view;
+}
+//# sourceMappingURL=emitter.js.map

package/dist/core/run-events/emitter.js.map

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

package/dist/core/run-events/frame-sink.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Writes screencast Frames as 'event: frame' SSE lines on the SAME response as the run-event
+ * stream; a closed/destroyed socket is skipped (a dead screencast must never break the run).
+ *
+ * Mirrors the structure of sse.ts but targets the separate Frame channel. Frames are a distinct
+ * SSE event type so the client's EventSource can addEventListener('frame', …) independently of
+ * the run-event kinds.
+ */
+import type { Frame, FrameSink } from '../run-mode/index.js';
+import type { SseResponse } from './sse.js';
+/** Serialize one screencast frame to an SSE frame (id + event:frame + data, blank-line terminated). */
+export declare function formatFrameSseFrame(frame: Frame): string;
+/**
+ * A FrameSink that writes each frame as an SSE 'event: frame' chunk to an HTTP response.
+ * The isClosed() guard ensures a disconnected or finished socket is silently skipped — a dead
+ * screencast consumer must never throw or break the orchestrator run.
+ */
+export declare class SseFrameSink implements FrameSink {
+    private readonly res;
+    constructor(res: SseResponse);
+    push(frame: Frame): void;
+    private isClosed;
+}
+//# sourceMappingURL=frame-sink.d.ts.map

package/dist/core/run-events/frame-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-sink.d.ts","sourceRoot":"","sources":["../../../core/run-events/frame-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,SAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,WAAW;IAE7C,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKxB,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/core/run-events/frame-sink.js

@@ -0,0 +1,32 @@
+/**
+ * Writes screencast Frames as 'event: frame' SSE lines on the SAME response as the run-event
+ * stream; a closed/destroyed socket is skipped (a dead screencast must never break the run).
+ *
+ * Mirrors the structure of sse.ts but targets the separate Frame channel. Frames are a distinct
+ * SSE event type so the client's EventSource can addEventListener('frame', …) independently of
+ * the run-event kinds.
+ */
+/** Serialize one screencast frame to an SSE frame (id + event:frame + data, blank-line terminated). */
+export function formatFrameSseFrame(frame) {
+    return `id: ${frame.seq}\nevent: frame\ndata: ${JSON.stringify(frame)}\n\n`;
+}
+/**
+ * A FrameSink that writes each frame as an SSE 'event: frame' chunk to an HTTP response.
+ * The isClosed() guard ensures a disconnected or finished socket is silently skipped — a dead
+ * screencast consumer must never throw or break the orchestrator run.
+ */
+export class SseFrameSink {
+    res;
+    constructor(res) {
+        this.res = res;
+    }
+    push(frame) {
+        if (this.isClosed())
+            return;
+        this.res.write(formatFrameSseFrame(frame));
+    }
+    isClosed() {
+        return this.res.writableEnded === true || this.res.destroyed === true;
+    }
+}
+//# sourceMappingURL=frame-sink.js.map

package/dist/core/run-events/frame-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-sink.js","sourceRoot":"","sources":["../../../core/run-events/frame-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,uGAAuG;AACvG,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,OAAO,OAAO,KAAK,CAAC,GAAG,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;IAAG,CAAC;IAEjD,IAAI,CAAC,KAAY;QACf,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAEO,QAAQ;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;IACxE,CAAC;CACF"}

package/dist/core/run-events/index.d.ts

@@ -0,0 +1,7 @@
+/** Run-event stream — public surface (Phase 3.3 Cockpit live-stream foundation). */
+export type { RunEvent, RunEventKind, RunEventSink, RunStartedEvent, PhaseStartedEvent, AgentStartedEvent, AgentFinishedEvent, AgentSkippedEvent, BudgetExceededEvent, GateEvaluatedEvent, PhaseFinishedEvent, RunFinishedEvent, QuestionAskedEvent, QuestionAnsweredEvent, RunAnswerDecision, PendingQuestionView, SkipReason, AgentView, RunStateView, } from './types.js';
+export { RunEventEmitter, NoopRunEventSink, InMemoryRunEventSink, FanOutRunEventSink, foldRunState, type RunEventEmitterOptions, } from './emitter.js';
+export { SseRunEventSink, formatSseFrame, initSse, SSE_HEADERS, type SseResponse, } from './sse.js';
+export { SseFrameSink, formatFrameSseFrame } from './frame-sink.js';
+export { SseLoopEventSink, formatLoopEventSseFrame, type AttributedLoopEvent } from './loop-event-sink.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/run-events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/run-events/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,cAAc,EACd,OAAO,EACP,WAAW,EACX,KAAK,WAAW,GACjB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/run-events/index.js

@@ -0,0 +1,5 @@
+export { RunEventEmitter, NoopRunEventSink, InMemoryRunEventSink, FanOutRunEventSink, foldRunState, } from './emitter.js';
+export { SseRunEventSink, formatSseFrame, initSse, SSE_HEADERS, } from './sse.js';
+export { SseFrameSink, formatFrameSseFrame } from './frame-sink.js';
+export { SseLoopEventSink, formatLoopEventSseFrame } from './loop-event-sink.js';
+//# sourceMappingURL=index.js.map

package/dist/core/run-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/run-events/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GAEb,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,cAAc,EACd,OAAO,EACP,WAAW,GAEZ,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAA4B,MAAM,mBAAmB,CAAC"}