@enricai/barnacle 1.6.12 → 1.6.14

package/dist/lib/telemetry/beacon-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"beacon-capture.js","sourceRoot":"","sources":["../../../src/lib/telemetry/beacon-capture.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,uCAAqC;AAGrC,qCAAkC;AAClC,2CAA0C;AAE1C,2EAA8E;AAE9E,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC;AAE/D,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAiBpC;;;;;;GAMG;AACI,KAAK,6BACV,KAAuB,EACvB,IAAI,GAA8B,EAAE;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IACzE,MAAM,MAAM,GAAsB;QAChC,GAAG,KAAK;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,IAAI,IAAI;QACzE,EAAE,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,MAAM,IAAA,6CAAwB,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,0CAA0C,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}
+{"version":3,"file":"beacon-capture.js","sourceRoot":"","sources":["../../../src/lib/telemetry/beacon-capture.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;AAEH,uCAAqC;AAGrC,qCAAkC;AAClC,2CAA0C;AAE1C,2EAA8E;AAE9E,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC;AAE/D,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAqBpC;;;;;;GAMG;AACI,KAAK,6BACV,KAAuB,EACvB,IAAI,GAA8B,EAAE;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IACzE,MAAM,MAAM,GAAsB;QAChC,GAAG,KAAK;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,IAAI,IAAI;QACzE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,EAAE,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,MAAM,IAAA,6CAAwB,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,0CAA0C,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AA6BD;;;;;;;;;;;;GAYG;AACH,qCACE,OAAqC;IAErC,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,kBAAkB,CACtB;gBACE,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;gBACtC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;aAClC,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,gDAAgD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/telemetry/reconciliation-record.d.ts

@@ -24,8 +24,30 @@
  * top-level keys, and a plain `z.object()` silently drops unrecognized
  * keys — reading an old line through the new schema would otherwise lose
  * its join keys rather than surface them.
+ *
+ * `session` (on `submitRecordSchema`) and `sessionIp` (on `beaconEventSchema`)
+ * carry the Browserbase session's identity and outbound IP so it's durable
+ * per-run telemetry rather than only a log line — every plugin acquires its
+ * session the same engine-owned way, so this lands here rather than
+ * per-plugin. Both are nullable-with-default for the same reason `joinKeys`
+ * is: millions of already-shipped NDJSON lines (and their S3 mirror) never
+ * carried these fields and must keep parsing.
  */
 import { z } from "zod/v4";
+/**
+ * The Browserbase session identity and outbound IP a plugin's run used.
+ * `ip`/`ipCapturedAt` are nullable independently of `id`/`provider` because
+ * the IP is only known after a separate in-session IP-echo navigation, which
+ * may never resolve (a disabled capture, a provider with no IP accessor, a
+ * timeout) even when the session itself was acquired successfully.
+ */
+export declare const sessionTelemetrySchema: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+    ip: z.ZodNullable<z.ZodString>;
+    ipCapturedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SessionTelemetry = z.infer<typeof sessionTelemetrySchema>;
 /**
  * Submit-side record: the existing submission envelope shape plus an opaque
  * `joinKeys` bag. Nullable-with-default so pre-existing lines that never
@@ -36,6 +58,12 @@ export declare const submitRecordSchema: z.ZodObject<{
     siteId: z.ZodString;
     requestId: z.ZodString;
     joinKeys: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodString;
+        ip: z.ZodNullable<z.ZodString>;
+        ipCapturedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     inboundPayload: z.ZodUnknown;
     status: z.ZodEnum<{
         error: "error";
@@ -56,7 +84,11 @@ export type SubmitRecord = z.infer<typeof submitRecordSchema>;
  * `dispatch()` in `src/plugins/loader.ts`) — distinct from `"not_fired"`
  * (the reader's fold default for a submit row with no matching beacon line
  * at all), so "submitted but the beacon did not fire" excludes runs that
- * never had a beacon to fire.
+ * never had a beacon to fire. `"skipped"` is not necessarily terminal for a
+ * self-managing plugin: if that plugin later records its own real `fired`/
+ * `failed` line for the same `requestId`, `foldReconciliationRecords` in
+ * `submission-reader.ts` ranks the real outcome above `"skipped"` and folds
+ * to that outcome regardless of which line was written first.
  */
 export declare const beaconEventSchema: z.ZodObject<{
     kind: z.ZodLiteral<"beacon">;
@@ -71,6 +103,7 @@ export declare const beaconEventSchema: z.ZodObject<{
     trackingUrl: z.ZodNullable<z.ZodString>;
     durationMs: z.ZodNumber;
     ts: z.ZodString;
+    sessionIp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type BeaconEvent = z.infer<typeof beaconEventSchema>;
 /**
@@ -86,6 +119,12 @@ export declare const reconciliationRecordSchema: z.ZodPipe<z.ZodTransform<unknow
     siteId: z.ZodString;
     requestId: z.ZodString;
     joinKeys: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodString;
+        ip: z.ZodNullable<z.ZodString>;
+        ipCapturedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     inboundPayload: z.ZodUnknown;
     status: z.ZodEnum<{
         error: "error";
@@ -108,6 +147,7 @@ export declare const reconciliationRecordSchema: z.ZodPipe<z.ZodTransform<unknow
     trackingUrl: z.ZodNullable<z.ZodString>;
     durationMs: z.ZodNumber;
     ts: z.ZodString;
+    sessionIp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>]>>;
 export type ReconciliationRecord = z.infer<typeof reconciliationRecordSchema>;
 //# sourceMappingURL=reconciliation-record.d.ts.map

package/dist/lib/telemetry/reconciliation-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconciliation-record.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAW7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAsB5D;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAOtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"reconciliation-record.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBAY7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAU5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAsB5D;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAOtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/lib/telemetry/reconciliation-record.js

@@ -25,10 +25,31 @@
  * top-level keys, and a plain `z.object()` silently drops unrecognized
  * keys — reading an old line through the new schema would otherwise lose
  * its join keys rather than surface them.
+ *
+ * `session` (on `submitRecordSchema`) and `sessionIp` (on `beaconEventSchema`)
+ * carry the Browserbase session's identity and outbound IP so it's durable
+ * per-run telemetry rather than only a log line — every plugin acquires its
+ * session the same engine-owned way, so this lands here rather than
+ * per-plugin. Both are nullable-with-default for the same reason `joinKeys`
+ * is: millions of already-shipped NDJSON lines (and their S3 mirror) never
+ * carried these fields and must keep parsing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reconciliationRecordSchema = exports.beaconEventSchema = exports.submitRecordSchema = void 0;
+exports.reconciliationRecordSchema = exports.beaconEventSchema = exports.submitRecordSchema = exports.sessionTelemetrySchema = void 0;
 const v4_1 = require("zod/v4");
+/**
+ * The Browserbase session identity and outbound IP a plugin's run used.
+ * `ip`/`ipCapturedAt` are nullable independently of `id`/`provider` because
+ * the IP is only known after a separate in-session IP-echo navigation, which
+ * may never resolve (a disabled capture, a provider with no IP accessor, a
+ * timeout) even when the session itself was acquired successfully.
+ */
+exports.sessionTelemetrySchema = v4_1.z.object({
+    id: v4_1.z.string(),
+    provider: v4_1.z.string(),
+    ip: v4_1.z.string().nullable(),
+    ipCapturedAt: v4_1.z.string().nullable(),
+});
 /**
  * Submit-side record: the existing submission envelope shape plus an opaque
  * `joinKeys` bag. Nullable-with-default so pre-existing lines that never
@@ -39,6 +60,7 @@ exports.submitRecordSchema = v4_1.z.object({
     siteId: v4_1.z.string(),
     requestId: v4_1.z.string(),
     joinKeys: v4_1.z.record(v4_1.z.string(), v4_1.z.unknown()).nullable().default(null),
+    session: exports.sessionTelemetrySchema.nullable().default(null),
     inboundPayload: v4_1.z.unknown(),
     status: v4_1.z.enum(["submitted", "error"]),
     auditPayload: v4_1.z.unknown(),
@@ -55,7 +77,11 @@ exports.submitRecordSchema = v4_1.z.object({
  * `dispatch()` in `src/plugins/loader.ts`) — distinct from `"not_fired"`
  * (the reader's fold default for a submit row with no matching beacon line
  * at all), so "submitted but the beacon did not fire" excludes runs that
- * never had a beacon to fire.
+ * never had a beacon to fire. `"skipped"` is not necessarily terminal for a
+ * self-managing plugin: if that plugin later records its own real `fired`/
+ * `failed` line for the same `requestId`, `foldReconciliationRecords` in
+ * `submission-reader.ts` ranks the real outcome above `"skipped"` and folds
+ * to that outcome regardless of which line was written first.
  */
 exports.beaconEventSchema = v4_1.z.object({
     kind: v4_1.z.literal("beacon"),
@@ -66,6 +92,7 @@ exports.beaconEventSchema = v4_1.z.object({
     trackingUrl: v4_1.z.string().nullable(),
     durationMs: v4_1.z.number(),
     ts: v4_1.z.string(),
+    sessionIp: v4_1.z.string().nullable().default(null),
 });
 /**
  * Folds a legacy top-level `vivclid`/`jobReference` shape into `joinKeys`

package/dist/lib/telemetry/reconciliation-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"reconciliation-record.js","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-record.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAEH,+BAA2B;AAE3B;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,MAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,MAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3C,MAAM,EAAE,MAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,MAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,MAAC,CAAC,MAAM,CAAC,MAAC,CAAC,MAAM,EAAE,EAAE,MAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACpE,cAAc,EAAE,MAAC,CAAC,OAAO,EAAE;IAC3B,MAAM,EAAE,MAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,EAAE,MAAC,CAAC,OAAO,EAAE;IACzB,YAAY,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE;IACtB,EAAE,EAAE,MAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAIH;;;;;;;;;;GAUG;AACU,QAAA,iBAAiB,GAAG,MAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,MAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,SAAS,EAAE,MAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,MAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,MAAC,CAAC,MAAM,CAAC,MAAC,CAAC,MAAM,EAAE,EAAE,MAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,MAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,WAAW,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE;IACtB,EAAE,EAAE,MAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAIH;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,KAA8B;IACxD,IAAI,UAAU,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,cAAc,GAClB,OAAO,IAAI,YAAY;QACrB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,YAAY,EAAE,YAAY,IAAI,IAAI,EAAE;QAClE,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,MAAC,CAAC,UAAU,CACpD,CAAC,KAAK,EAAE,EAAE;IACR,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACxE,OAAO,kBAAkB,CAAC,QAAmC,CAAC,CAAC;AACjE,CAAC,EACD,MAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,QAAA,kBAAkB,EAAE,QAAA,iBAAiB,CAAC,CAAC,CACtE,CAAC"}
+{"version":3,"file":"reconciliation-record.js","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-record.ts"],"names":[],"mappings":"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"}

package/dist/lib/telemetry/reconciliation-source.d.ts

@@ -13,7 +13,13 @@
  * every event (`appendSubmissionSinkLine` writes to disk and buffers to S3
  * in the same call), so an overlap between the two stores is an exact JSON
  * duplicate, never a conflicting value — deduping on `kind:requestId:ts` is
- * therefore lossless.
+ * lossless for that mirror case. But `ts` is formatISO second-precision, so
+ * two *distinct* beacon lines for the same `requestId` (e.g. dispatch's
+ * automatic `skipped` line and a plugin's later self-recorded `fired` line)
+ * can land in the same wall-clock second — the dedupe key for beacon
+ * records also folds in `beaconStatus` and `trackingUrl` so non-identical
+ * beacon outcomes never collide, while submit records keep the plain
+ * `kind:requestId:ts` key.
  */
 import { type ReconciliationRow } from "../../lib/telemetry/submission-reader";
 import { type ListSubmissionsS3ObjectsOptions } from "../../lib/telemetry/submissions-s3-objects";

package/dist/lib/telemetry/reconciliation-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconciliation-source.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,+BAA+B,EAErC,MAAM,wCAAwC,CAAC;AAKhD,mDAAmD;AACnD,MAAM,WAAW,oCAAqC,SAAQ,+BAA+B;IAC3F,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwDD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,GAAE,oCAAyC,GAC9C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAS9B"}
+{"version":3,"file":"reconciliation-source.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,+BAA+B,EAErC,MAAM,wCAAwC,CAAC;AAKhD,mDAAmD;AACnD,MAAM,WAAW,oCAAqC,SAAQ,+BAA+B;IAC3F,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkED;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,GAAE,oCAAyC,GAC9C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAS9B"}

package/dist/lib/telemetry/reconciliation-source.js

@@ -14,7 +14,13 @@
  * every event (`appendSubmissionSinkLine` writes to disk and buffers to S3
  * in the same call), so an overlap between the two stores is an exact JSON
  * duplicate, never a conflicting value — deduping on `kind:requestId:ts` is
- * therefore lossless.
+ * lossless for that mirror case. But `ts` is formatISO second-precision, so
+ * two *distinct* beacon lines for the same `requestId` (e.g. dispatch's
+ * automatic `skipped` line and a plugin's later self-recorded `fired` line)
+ * can land in the same wall-clock second — the dedupe key for beacon
+ * records also folds in `beaconStatus` and `trackingUrl` so non-identical
+ * beacon outcomes never collide, while submit records keep the plain
+ * `kind:requestId:ts` key.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readDurableReconciliationRows = readDurableReconciliationRows;
@@ -57,14 +63,24 @@ async function readS3Records(opts) {
         return [];
     }
 }
-/** Dedupe key for a raw record: the same line written to both stores collapses to one. */
+/**
+ * Dedupe key for a raw record: the same line written to both stores
+ * collapses to one. Beacon records also key on `beaconStatus` and
+ * `trackingUrl` — `ts` alone is second-precision, so a `skipped` line and a
+ * later `fired`/`failed` line for the same `requestId` can share a `ts` and
+ * must not be treated as the same line.
+ */
 function dedupeKey(record) {
+    if (record.kind === "beacon") {
+        return `${record.kind}:${record.requestId}:${record.ts}:${record.beaconStatus}:${record.trackingUrl ?? ""}`;
+    }
     return `${record.kind}:${record.requestId}:${record.ts}`;
 }
 /**
- * Unions the two record sets, local first, and dedupes on
- * `kind:requestId:ts` — the same line written to both stores collapses to
- * one entry, so `foldReconciliationRecords` sees it exactly once.
+ * Unions the two record sets, local first, and dedupes with `dedupeKey` —
+ * the same line written to both stores collapses to one entry, so
+ * `foldReconciliationRecords` sees it exactly once, while distinct beacon
+ * outcomes sharing a `requestId`/`ts` both survive.
  */
 function mergeRecords(localRecords, s3Records) {
     const deduped = new Map();

package/dist/lib/telemetry/reconciliation-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"reconciliation-source.js","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-source.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,qCAAqC;AACrC,+CAA4C;AAE5C,qCAAkC;AAClC,yCAA8C;AAC9C,2CAA0C;AAE1C,yEAI2C;AAC3C,mFAGgD;AAChD,iFAAkF;AAElF,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;AAQtE;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,IAAA,4CAAwB,EAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAC1B,IAAqC;IAErC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAA,iDAAwB,EAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,MAAM,IAAA,iDAAyB,EAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,2EAA2E,IAAA,uBAAc,EAAC,GAAG,CAAC,EAAE,CACjG,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,SAAS,SAAS,CAAC,MAA4B;IAC7C,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CACnB,YAAoC,EACpC,SAAiC;IAEjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,wCACV,IAAI,GAAyC,EAAE;IAE/C,MAAM,EAAE,QAAQ,GAAG,eAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAElF,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,gBAAgB,CAAC,QAAQ,CAAC;QAC1B,aAAa,CAAC,UAAU,CAAC;KAC1B,CAAC,CAAC;IAEH,OAAO,IAAA,6CAAyB,EAAC,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"reconciliation-source.js","sourceRoot":"","sources":["../../../src/lib/telemetry/reconciliation-source.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,qCAAqC;AACrC,+CAA4C;AAE5C,qCAAkC;AAClC,yCAA8C;AAC9C,2CAA0C;AAE1C,yEAI2C;AAC3C,mFAGgD;AAChD,iFAAkF;AAElF,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;AAQtE;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,IAAA,4CAAwB,EAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAC1B,IAAqC;IAErC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAA,iDAAwB,EAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,MAAM,IAAA,iDAAyB,EAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,2EAA2E,IAAA,uBAAc,EAAC,GAAG,CAAC,EAAE,CACjG,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,MAA4B;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;IAC9G,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,YAAoC,EACpC,SAAiC;IAEjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,wCACV,IAAI,GAAyC,EAAE;IAE/C,MAAM,EAAE,QAAQ,GAAG,eAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAElF,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,gBAAgB,CAAC,QAAQ,CAAC;QAC1B,aAAa,CAAC,UAAU,CAAC;KAC1B,CAAC,CAAC;IAEH,OAAO,IAAA,6CAAyB,EAAC,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/lib/telemetry/run-telemetry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Run-scoped, mutable telemetry accumulator that a plugin can write
+ * discovered fields into at any point during execute()/executeHttp() —
+ * mirrors `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
+ * instance meant to be threaded through the plugin context, but for
+ * run-discovered data (join keys, session info) rather than step timings.
+ * Funnels everything a plugin discovers mid-run into the same opaque
+ * `joinKeys` bag already documented in `reconciliation-record.ts`, rather
+ * than inventing a second bag.
+ */
+/** Browserbase session identity/network facts recorded once per run. */
+export interface SessionTelemetry {
+    sessionId: string;
+    provider: string;
+    ip: string | null;
+    ipCapturedAt: string | null;
+}
+/** Point-in-time view of everything accumulated on a `RunTelemetry` instance. */
+export interface RunTelemetrySnapshot {
+    joinKeys: Record<string, unknown> | null;
+    session: SessionTelemetry | null;
+}
+/**
+ * Public surface `SitePluginContext.telemetry` exposes to plugins. Declared
+ * separately from the `RunTelemetry` class (rather than using the class
+ * itself as the field type) so consumers — including this repo's own test
+ * doubles — can satisfy the contract with a plain object; `RunTelemetry`'s
+ * private accumulator fields would otherwise make it structurally
+ * unsatisfiable by anything but the class itself.
+ */
+export interface RunTelemetryHandle {
+    addJoinKeys(fields: Record<string, unknown>): void;
+    recordSession(info: SessionTelemetry): void;
+    snapshot(): RunTelemetrySnapshot;
+}
+/**
+ * Accumulates run-discovered join keys and session telemetry for a single
+ * dispatch invocation. Constructed per-request in `buildPluginContext`
+ * (`src/plugins/loader.ts`) and threaded through `SitePluginContext.telemetry`
+ * so a plugin can attach fields it only learns mid-run — a token minted
+ * mid-flow, a value read from the page after navigation — instead of being
+ * limited to `extractJoinKeys`'s inbound-payload-only view.
+ */
+export declare class RunTelemetry implements RunTelemetryHandle {
+    private joinKeys;
+    private session;
+    /**
+     * Merges `fields` into the accumulated join-key bag. Later calls win on
+     * key collision, so a plugin can refine an early guess as the run
+     * progresses without losing earlier keys it doesn't repeat.
+     */
+    addJoinKeys(fields: Record<string, unknown>): void;
+    /**
+     * Records Browserbase session identity/network facts. Last-write-wins
+     * (whole-object replace) since a run has at most one active session at a
+     * time — unlike join keys, there's no reason to merge partial calls.
+     */
+    recordSession(info: SessionTelemetry): void;
+    /**
+     * Returns a defensive copy of everything accumulated so far. `joinKeys`
+     * stays `null` (not `{}`) when nothing was ever added, so dispatch can
+     * keep emitting `joinKeys: null` unchanged until a plugin actually writes
+     * to this collector.
+     */
+    snapshot(): RunTelemetrySnapshot;
+}
+//# sourceMappingURL=run-telemetry.d.ts.map

package/dist/lib/telemetry/run-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-telemetry.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/run-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnD,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,QAAQ,IAAI,oBAAoB,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,kBAAkB;IACrD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAAiC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEjD;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAE1C;IAED;;;;;OAKG;IACH,QAAQ,IAAI,oBAAoB,CAK/B;CACF"}

package/dist/lib/telemetry/run-telemetry.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Run-scoped, mutable telemetry accumulator that a plugin can write
+ * discovered fields into at any point during execute()/executeHttp() —
+ * mirrors `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
+ * instance meant to be threaded through the plugin context, but for
+ * run-discovered data (join keys, session info) rather than step timings.
+ * Funnels everything a plugin discovers mid-run into the same opaque
+ * `joinKeys` bag already documented in `reconciliation-record.ts`, rather
+ * than inventing a second bag.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunTelemetry = void 0;
+/**
+ * Accumulates run-discovered join keys and session telemetry for a single
+ * dispatch invocation. Constructed per-request in `buildPluginContext`
+ * (`src/plugins/loader.ts`) and threaded through `SitePluginContext.telemetry`
+ * so a plugin can attach fields it only learns mid-run — a token minted
+ * mid-flow, a value read from the page after navigation — instead of being
+ * limited to `extractJoinKeys`'s inbound-payload-only view.
+ */
+class RunTelemetry {
+    joinKeys = null;
+    session = null;
+    /**
+     * Merges `fields` into the accumulated join-key bag. Later calls win on
+     * key collision, so a plugin can refine an early guess as the run
+     * progresses without losing earlier keys it doesn't repeat.
+     */
+    addJoinKeys(fields) {
+        this.joinKeys = { ...this.joinKeys, ...fields };
+    }
+    /**
+     * Records Browserbase session identity/network facts. Last-write-wins
+     * (whole-object replace) since a run has at most one active session at a
+     * time — unlike join keys, there's no reason to merge partial calls.
+     */
+    recordSession(info) {
+        this.session = info;
+    }
+    /**
+     * Returns a defensive copy of everything accumulated so far. `joinKeys`
+     * stays `null` (not `{}`) when nothing was ever added, so dispatch can
+     * keep emitting `joinKeys: null` unchanged until a plugin actually writes
+     * to this collector.
+     */
+    snapshot() {
+        return {
+            joinKeys: this.joinKeys ? { ...this.joinKeys } : null,
+            session: this.session ? { ...this.session } : null,
+        };
+    }
+}
+exports.RunTelemetry = RunTelemetry;
+//# sourceMappingURL=run-telemetry.js.map

package/dist/lib/telemetry/run-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-telemetry.js","sourceRoot":"","sources":["../../../src/lib/telemetry/run-telemetry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA8BH;;;;;;;GAOG;AACH;IACU,QAAQ,GAAmC,IAAI,CAAC;IAChD,OAAO,GAA4B,IAAI,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,MAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAsB;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;YACrD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;SACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/lib/telemetry/submission-capture.d.ts

@@ -24,6 +24,12 @@ export declare const submissionEnvelopeSampleSchema: z.ZodObject<{
     siteId: z.ZodString;
     requestId: z.ZodString;
     joinKeys: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    session: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodString;
+        ip: z.ZodNullable<z.ZodString>;
+        ipCapturedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     inboundPayload: z.ZodUnknown;
     status: z.ZodEnum<{
         error: "error";
@@ -37,12 +43,13 @@ export declare const submissionEnvelopeSampleSchema: z.ZodObject<{
 export type SubmissionEnvelopeSample = z.infer<typeof submissionEnvelopeSampleSchema>;
 /**
  * Input to `captureSubmissionEnvelope` — `ts` and `kind` are derived
- * internally so callers omit them. `joinKeys` is optional so existing call
- * sites that don't yet resolve join keys keep compiling unchanged; an
- * omitted value is persisted as `null`, not left undefined.
+ * internally so callers omit them. `joinKeys`/`session` are optional so
+ * existing call sites that don't yet resolve them keep compiling unchanged;
+ * an omitted value is persisted as `null`, not left undefined.
  */
-export type SubmissionEnvelopeInput = Omit<SubmissionEnvelopeSample, "ts" | "kind" | "joinKeys"> & {
+export type SubmissionEnvelopeInput = Omit<SubmissionEnvelopeSample, "ts" | "kind" | "joinKeys" | "session"> & {
     joinKeys?: Record<string, unknown> | null;
+    session?: SubmissionEnvelopeSample["session"];
 };
 /** Options for `captureSubmissionEnvelope`. */
 export interface CaptureSubmissionOptions {

package/dist/lib/telemetry/submission-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submission-capture.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAShC;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;iBAAqB,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GAAG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEF,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,uBAAuB,EAC9B,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"submission-capture.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAShC;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;iBAAqB,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,wBAAwB,EACxB,IAAI,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CACvC,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;CAC/C,CAAC;AAEF,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,uBAAuB,EAC9B,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/lib/telemetry/submission-capture.js

@@ -55,6 +55,7 @@ async function captureSubmissionEnvelope(input, opts = {}) {
         ...input,
         kind: "submit",
         joinKeys: input.joinKeys ?? null,
+        session: input.session ?? null,
         ts: (0, date_fns_1.formatISO)(new Date()),
     };
     try {

package/dist/lib/telemetry/submission-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"submission-capture.js","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-capture.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;AAEH,+CAAqD;AACrD,yCAAoC;AAEpC,uCAAqC;AAGrC,qCAAkC;AAClC,2CAA0C;AAC1C,iFAA2E;AAC3E,qDAA+D;AAE/D,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC;AAEnE;;;;;;GAMG;AACU,QAAA,8BAA8B,GAAG,0CAAkB,CAAC;AAoBjE;;;;;;GAMG;AACI,KAAK,mCAAmC,QAAgB,EAAE,IAAY;IAC3E,MAAM,IAAA,gBAAK,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,IAAA,qBAAU,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,IAAA,8BAAoB,EAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACI,KAAK,oCACV,KAA8B,EAC9B,IAAI,GAA6B,EAAE;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IACzE,MAAM,MAAM,GAA6B;QACvC,GAAG,KAAK;QACR,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,EAAE,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,MAAM,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,iDAAiD,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}
+{"version":3,"file":"submission-capture.js","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-capture.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;AAEH,+CAAqD;AACrD,yCAAoC;AAEpC,uCAAqC;AAGrC,qCAAkC;AAClC,2CAA0C;AAC1C,iFAA2E;AAC3E,qDAA+D;AAE/D,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC;AAEnE;;;;;;GAMG;AACU,QAAA,8BAA8B,GAAG,0CAAkB,CAAC;AAwBjE;;;;;;GAMG;AACI,KAAK,mCAAmC,QAAgB,EAAE,IAAY;IAC3E,MAAM,IAAA,gBAAK,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,IAAA,qBAAU,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,IAAA,8BAAoB,EAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACI,KAAK,oCACV,KAA8B,EAC9B,IAAI,GAA6B,EAAE;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IACzE,MAAM,MAAM,GAA6B;QACvC,GAAG,KAAK;QACR,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,EAAE,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,MAAM,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,iDAAiD,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/lib/telemetry/submission-reader.d.ts

@@ -14,13 +14,19 @@ import { type BeaconEvent, type ReconciliationRecord, type SubmitRecord } from "
  * One reconciliation row per run: the submit record's fields plus the
  * outcome of its beacon fire, distinct from submit status so "submitted but
  * the beacon did not fire" is measurable. `beaconStatus` defaults to
- * `"not_fired"` when no matching beacon line ever arrived.
+ * `"not_fired"` when no matching beacon line ever arrived. When a run has
+ * both a `"skipped"` line and a real `"fired"`/`"failed"` line, the real
+ * outcome wins the fold (see `foldReconciliationRecords`) regardless of
+ * which line was written first. `beaconSessionIp` is the tracking-click
+ * session's own outbound IP — distinct from the submit line's `session.ip`,
+ * since the two are separate Browserbase sessions per run.
  */
 export interface ReconciliationRow extends Omit<SubmitRecord, "kind"> {
     beaconStatus: BeaconEvent["beaconStatus"] | "not_fired";
     beaconTrackingUrl: string | null;
     beaconTs: string | null;
     beaconDurationMs: number | null;
+    beaconSessionIp: string | null;
 }
 /** Options for `readReconciliationRows`. */
 export interface ReadReconciliationRowsOptions {
@@ -38,8 +44,10 @@ export declare function parseReconciliationLines(ndjsonContent: string): Reconci
  * Left-joins beacon events onto submit records by `requestId`. Submit rows
  * are the base — a beacon may arrive strictly after its submit line (or
  * never), so an orphan beacon with no matching submit row is dropped rather
- * than synthesizing a phantom row. A later duplicate line (retry) overwrites
- * an earlier one for the same `requestId` and kind.
+ * than synthesizing a phantom row. Among beacon lines for the same
+ * `requestId`, the highest-`beaconRank` line wins regardless of write
+ * order; ties (equal rank) fall back to a later line overwriting an
+ * earlier one, so a duplicate/retry still resolves deterministically.
  */
 export declare function foldReconciliationRecords(records: ReconciliationRecord[]): ReconciliationRow[];
 /**

package/dist/lib/telemetry/submission-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submission-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAClB,MAAM,uCAAuC,CAAC;AAI/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACnE,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;IACxD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA2BtF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,iBAAiB,EAAE,CA6B9F;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B"}
+{"version":3,"file":"submission-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAClB,MAAM,uCAAuC,CAAC;AAI/C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACnE,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;IACxD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA2BtF;AAcD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,iBAAiB,EAAE,CA2C9F;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B"}

package/dist/lib/telemetry/submission-reader.js

@@ -58,12 +58,25 @@ function parseReconciliationLines(ndjsonContent) {
     }
     return records;
 }
+/**
+ * Rank of a beacon outcome for fold precedence: a real `fired`/`failed`
+ * outcome always outranks `skipped`, because `dispatch()` writes `skipped`
+ * synchronously for any self-managing plugin (`loader.ts`) before that
+ * plugin's own later-recorded real outcome can arrive — write order alone
+ * is not a safe proxy for which line reflects reality. Equal-rank lines
+ * (e.g. a retried `fired`) fall through to array order, i.e. last one wins.
+ */
+function beaconRank(beaconStatus) {
+    return beaconStatus === "skipped" ? 0 : 1;
+}
 /**
  * Left-joins beacon events onto submit records by `requestId`. Submit rows
  * are the base — a beacon may arrive strictly after its submit line (or
  * never), so an orphan beacon with no matching submit row is dropped rather
- * than synthesizing a phantom row. A later duplicate line (retry) overwrites
- * an earlier one for the same `requestId` and kind.
+ * than synthesizing a phantom row. Among beacon lines for the same
+ * `requestId`, the highest-`beaconRank` line wins regardless of write
+ * order; ties (equal rank) fall back to a later line overwriting an
+ * earlier one, so a duplicate/retry still resolves deterministically.
  */
 function foldReconciliationRecords(records) {
     const rows = new Map();
@@ -77,20 +90,31 @@ function foldReconciliationRecords(records) {
             beaconTrackingUrl: null,
             beaconTs: null,
             beaconDurationMs: null,
+            beaconSessionIp: null,
         });
     }
+    const winningBeacons = new Map();
     for (const record of records) {
         if (record.kind !== "beacon")
             continue;
-        const row = rows.get(record.requestId);
+        const current = winningBeacons.get(record.requestId);
+        if (current !== undefined &&
+            beaconRank(current.beaconStatus) > beaconRank(record.beaconStatus)) {
+            continue;
+        }
+        winningBeacons.set(record.requestId, record);
+    }
+    for (const [requestId, beacon] of winningBeacons) {
+        const row = rows.get(requestId);
         if (row === undefined)
             continue;
-        rows.set(record.requestId, {
+        rows.set(requestId, {
             ...row,
-            beaconStatus: record.beaconStatus,
-            beaconTrackingUrl: record.trackingUrl,
-            beaconTs: record.ts,
-            beaconDurationMs: record.durationMs,
+            beaconStatus: beacon.beaconStatus,
+            beaconTrackingUrl: beacon.trackingUrl,
+            beaconTs: beacon.ts,
+            beaconDurationMs: beacon.durationMs,
+            beaconSessionIp: beacon.sessionIp,
         });
     }
     return Array.from(rows.values());

package/dist/lib/telemetry/submission-reader.js.map

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

package/dist/lib/tracking-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking-click.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAiFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,kCAAkC,GAClD,IAAI,CAKN;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}
+{"version":3,"file":"tracking-click.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAqGD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,kCAAkC,GAClD,IAAI,CAKN;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}

package/dist/lib/tracking-click.js

@@ -38,6 +38,23 @@ async function captureBeaconOutcomeSafely(input) {
         logger.warn(`beacon outcome capture failed: ${(0, errors_1.toErrorMessage)(err)}`);
     }
 }
+/**
+ * Resolves the given session's outbound IP for the beacon record. Never
+ * throws — a resolution failure (or a session/provider without the
+ * accessor) yields `null` rather than blocking the beacon write, matching
+ * the same never-throw contract `getOutboundIp` itself already applies.
+ */
+async function resolveSessionIp(session) {
+    if (!session?.getOutboundIp)
+        return null;
+    try {
+        return await session.getOutboundIp();
+    }
+    catch (err) {
+        logger.warn(`tracking click session IP resolution failed: ${(0, errors_1.toErrorMessage)(err)}`);
+        return null;
+    }
+}
 /**
  * Navigates a Browserbase session to the tracking URL. Errors are logged
  * and swallowed — the apply already succeeded, so a failed tracking click
@@ -65,6 +82,7 @@ async function executeTrackingClick(trackingUrl, siteId, reconciliation) {
                 beaconStatus: "fired",
                 trackingUrl,
                 durationMs: Date.now() - startedAt,
+                sessionIp: await resolveSessionIp(session),
             });
         }
     }
@@ -79,6 +97,7 @@ async function executeTrackingClick(trackingUrl, siteId, reconciliation) {
                 beaconStatus: "failed",
                 trackingUrl,
                 durationMs: Date.now() - startedAt,
+                sessionIp: await resolveSessionIp(session),
             });
         }
     }