agentfootprint 9.8.0 → 9.9.0

package/dist/esm/lib/bug-report/zip.js

@@ -0,0 +1,202 @@
+/**
+ * zipStore — a real `.zip` file, STORED (no compression), in ~150 lines and
+ * zero dependencies.
+ *
+ * ## Why store-only is the honest choice here
+ *
+ * This writer exists for ONE payload: a bug-report bundle, which is JSON and
+ * text. Deflate would shrink it well — and would cost this library either a
+ * dependency (a zlib binding in a package that has none) or `node:zlib` (which
+ * makes the export Node-only, when building the bundle in a browser is exactly
+ * the flow the consent manifest is for). Store-only keeps the export
+ * environment-neutral and the writer small enough to read in one sitting.
+ *
+ * The trade is stated rather than hidden: **a stored bundle is roughly the sum
+ * of its files.** A 9 MB recording produces a ~9 MB zip. Every unzip tool reads
+ * it — `unzip`, Finder, Explorer, `zipfile.ZipFile`, `jar` — because method 0
+ * is the oldest thing in the format. If a bundle is too big to attach, the
+ * answer is to send fewer conversations (which the manifest's trim hints name),
+ * not to compress harder; that is the same answer a deflated bundle would give
+ * one doubling later.
+ *
+ * ## What it writes, exactly
+ *
+ * One local file header + data per entry, then one central-directory header per
+ * entry, then the end-of-central-directory record — the classic three-part
+ * layout from APPNOTE.TXT, no data descriptors, no zip64, no archive comment.
+ * Names are UTF-8 with the language-encoding flag (bit 11) set, so a non-ASCII
+ * name is not mojibake on a reader that honours the flag.
+ *
+ * ## What it refuses
+ *
+ * A path that would escape the extraction directory (`/leading`, `..`, a drive
+ * letter, a backslash) is refused BY NAME rather than written — a bug-report
+ * bundle is opened by a maintainer on their own machine, and "zip slip" is the
+ * one way a report could hurt the person reading it. Duplicate names, empty
+ * names, an entry over 4 GB and more than 65,535 entries are refused too: those
+ * are the boundaries of the non-zip64 format, and writing past them silently
+ * produces a file that fails to open.
+ *
+ * @example
+ * ```ts
+ * const bytes = zipStore([
+ *   { name: 'manifest.json', data: new TextEncoder().encode('{}') },
+ * ]);
+ * ```
+ *
+ * @internal Not a public export. `exportBugReport` is the door.
+ */
+/** Non-zip64 ceilings. Past either, the file this would write cannot be read. */
+const MAX_ENTRY_BYTES = 0xffffffff;
+const MAX_ENTRIES = 0xffff;
+const LOCAL_SIG = 0x04034b50;
+const CENTRAL_SIG = 0x02014b50;
+const EOCD_SIG = 0x06054b50;
+/** 2.0 — the version that has stored + deflated entries. */
+const VERSION_NEEDED = 20;
+/** Bit 11: the name (and comment) are UTF-8. */
+const FLAG_UTF8 = 0x0800;
+const METHOD_STORE = 0;
+/**
+ * Build a stored (uncompressed) zip archive.
+ *
+ * @throws TypeError naming the offending entry when a name is unsafe or
+ *         duplicated, or when the archive would exceed the non-zip64 limits.
+ */
+export function zipStore(entries, options = {}) {
+    if (entries.length > MAX_ENTRIES) {
+        throw new TypeError(`zipStore: ${entries.length} entries exceeds the ${MAX_ENTRIES}-entry limit of a ` +
+            `non-zip64 archive. Bundle fewer files (or fold them into one JSON file).`);
+    }
+    const { dosTime, dosDate } = toDosDateTime(options.modified ?? new Date());
+    const encoder = new TextEncoder();
+    const seen = new Set();
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const entry of entries) {
+        const name = checkedName(entry.name, seen);
+        seen.add(name);
+        if (entry.data.length > MAX_ENTRY_BYTES) {
+            throw new TypeError(`zipStore: entry '${name}' is ${entry.data.length} bytes, past the 4 GB ceiling of a ` +
+                `non-zip64 archive. Split it, or leave it out of the bundle.`);
+        }
+        const nameBytes = encoder.encode(name);
+        const crc = crc32(entry.data);
+        const size = entry.data.length;
+        const local = new Uint8Array(30 + nameBytes.length);
+        const lv = new DataView(local.buffer);
+        lv.setUint32(0, LOCAL_SIG, true);
+        lv.setUint16(4, VERSION_NEEDED, true);
+        lv.setUint16(6, FLAG_UTF8, true);
+        lv.setUint16(8, METHOD_STORE, true);
+        lv.setUint16(10, dosTime, true);
+        lv.setUint16(12, dosDate, true);
+        lv.setUint32(14, crc, true);
+        lv.setUint32(18, size, true); // compressed === uncompressed when stored
+        lv.setUint32(22, size, true);
+        lv.setUint16(26, nameBytes.length, true);
+        lv.setUint16(28, 0, true); // no extra field
+        local.set(nameBytes, 30);
+        const central = new Uint8Array(46 + nameBytes.length);
+        const cv = new DataView(central.buffer);
+        cv.setUint32(0, CENTRAL_SIG, true);
+        cv.setUint16(4, VERSION_NEEDED, true); // version made by
+        cv.setUint16(6, VERSION_NEEDED, true); // version needed
+        cv.setUint16(8, FLAG_UTF8, true);
+        cv.setUint16(10, METHOD_STORE, true);
+        cv.setUint16(12, dosTime, true);
+        cv.setUint16(14, dosDate, true);
+        cv.setUint32(16, crc, true);
+        cv.setUint32(20, size, true);
+        cv.setUint32(24, size, true);
+        cv.setUint16(28, nameBytes.length, true);
+        cv.setUint16(30, 0, true); // extra length
+        cv.setUint16(32, 0, true); // comment length
+        cv.setUint16(34, 0, true); // disk number start
+        cv.setUint16(36, 0, true); // internal attributes
+        cv.setUint32(38, 0, true); // external attributes
+        cv.setUint32(42, offset, true); // where this entry's local header sits
+        central.set(nameBytes, 46);
+        locals.push(local, entry.data);
+        centrals.push(central);
+        offset += local.length + size;
+    }
+    const centralSize = centrals.reduce((sum, part) => sum + part.length, 0);
+    const eocd = new Uint8Array(22);
+    const ev = new DataView(eocd.buffer);
+    ev.setUint32(0, EOCD_SIG, true);
+    ev.setUint16(4, 0, true); // this disk
+    ev.setUint16(6, 0, true); // disk with the central directory
+    ev.setUint16(8, entries.length, true);
+    ev.setUint16(10, entries.length, true);
+    ev.setUint32(12, centralSize, true);
+    ev.setUint32(16, offset, true); // central directory starts after the data
+    ev.setUint16(20, 0, true); // no archive comment
+    return concat([...locals, ...centrals, eocd]);
+}
+/**
+ * The one name rule: relative, `/`-separated, no traversal. A bug report is
+ * extracted by the person it was filed against; this is the line between a
+ * bundle and a payload.
+ */
+function checkedName(name, seen) {
+    if (!name)
+        throw new TypeError('zipStore: an entry has an empty name.');
+    if (seen.has(name)) {
+        throw new TypeError(`zipStore: two entries are both named '${name}'. A zip may hold duplicates and most ` +
+            `readers silently keep the last one, so the writer refuses instead.`);
+    }
+    const unsafe = name.startsWith('/') ||
+        name.includes('\\') ||
+        /^[a-zA-Z]:/.test(name) ||
+        name.split('/').includes('..');
+    if (unsafe) {
+        throw new TypeError(`zipStore: refusing the entry name '${name}'. Names must be RELATIVE and ` +
+            `'/'-separated, with no '..' segment, no leading '/', no backslash and no drive ` +
+            `letter — an archive is extracted on somebody else's machine, and a path that ` +
+            `escapes the extraction directory is how a report hurts the person reading it.`);
+    }
+    return name;
+}
+/** MS-DOS date/time, the only timestamp a base zip entry carries. */
+function toDosDateTime(date) {
+    const when = Number.isFinite(date.getTime()) ? date : new Date();
+    const year = when.getFullYear();
+    // DOS epoch is 1980. Rather than write a negative year field (which readers
+    // render as garbage), clamp — the timestamp is provenance, not evidence.
+    if (year < 1980)
+        return { dosTime: 0, dosDate: (1 << 5) | 1 };
+    const dosTime = (when.getHours() << 11) | (when.getMinutes() << 5) | Math.floor(when.getSeconds() / 2);
+    const dosDate = ((year - 1980) << 9) | ((when.getMonth() + 1) << 5) | when.getDate();
+    return { dosTime, dosDate };
+}
+/** CRC-32 (IEEE 802.3), table built once on first use. */
+let crcTable;
+export function crc32(bytes) {
+    if (!crcTable) {
+        crcTable = new Uint32Array(256);
+        for (let i = 0; i < 256; i++) {
+            let c = i;
+            for (let bit = 0; bit < 8; bit++)
+                c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+            crcTable[i] = c >>> 0;
+        }
+    }
+    let crc = 0xffffffff;
+    for (let i = 0; i < bytes.length; i++) {
+        crc = crcTable[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function concat(parts) {
+    const total = parts.reduce((sum, part) => sum + part.length, 0);
+    const out = new Uint8Array(total);
+    let at = 0;
+    for (const part of parts) {
+        out.set(part, at);
+        at += part.length;
+    }
+    return out;
+}
+//# sourceMappingURL=zip.js.map

package/dist/esm/lib/bug-report/zip.js.map

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

package/dist/esm/lib/libraryVersion.d.ts

@@ -0,0 +1,23 @@
+/**
+ * libraryVersion — "which version of this library produced that?"
+ *
+ * Anything that ships a record of a run out of the process — an audit chain, a
+ * bug-report bundle — has to stamp the library version on it, or the person
+ * reading it months later is comparing behaviour against a version they are
+ * guessing at. That is one job, so it is one function: two copies of this walk
+ * would be two answers to a question that must have exactly one.
+ *
+ * It reads the package manifest through `lazyRequire`, trying the installed
+ * specifier first and then the relative paths that work from `dist/` and from
+ * `dist/esm/`. The `name` guard rejects any manifest that is not ours — a
+ * relative walk in a consumer's tree can otherwise find THEIR package.json and
+ * stamp a record with the application's version.
+ *
+ * Never throws, and answers `'unknown'` when it cannot tell. A version that
+ * cannot be read is a stamp that says so; a thrown error here would take down
+ * the export that merely wanted to label itself.
+ */
+/** This library's own version, or `'unknown'`. */
+export declare function libraryVersion(): string;
+/** The engine underneath, or `'unknown'` — the other half of "which versions?". */
+export declare function engineVersion(): string;

package/dist/esm/lib/libraryVersion.js

@@ -0,0 +1,46 @@
+/**
+ * libraryVersion — "which version of this library produced that?"
+ *
+ * Anything that ships a record of a run out of the process — an audit chain, a
+ * bug-report bundle — has to stamp the library version on it, or the person
+ * reading it months later is comparing behaviour against a version they are
+ * guessing at. That is one job, so it is one function: two copies of this walk
+ * would be two answers to a question that must have exactly one.
+ *
+ * It reads the package manifest through `lazyRequire`, trying the installed
+ * specifier first and then the relative paths that work from `dist/` and from
+ * `dist/esm/`. The `name` guard rejects any manifest that is not ours — a
+ * relative walk in a consumer's tree can otherwise find THEIR package.json and
+ * stamp a record with the application's version.
+ *
+ * Never throws, and answers `'unknown'` when it cannot tell. A version that
+ * cannot be read is a stamp that says so; a thrown error here would take down
+ * the export that merely wanted to label itself.
+ */
+import { lazyRequire } from './lazyRequire.js';
+function versionOf(packageName, candidates) {
+    for (const specifier of candidates) {
+        try {
+            const pkg = lazyRequire(specifier);
+            if (pkg.name === packageName && typeof pkg.version === 'string')
+                return pkg.version;
+        }
+        catch {
+            /* try the next candidate */
+        }
+    }
+    return 'unknown';
+}
+/** This library's own version, or `'unknown'`. */
+export function libraryVersion() {
+    return versionOf('agentfootprint', [
+        'agentfootprint/package.json',
+        '../../package.json',
+        '../../../package.json',
+    ]);
+}
+/** The engine underneath, or `'unknown'` — the other half of "which versions?". */
+export function engineVersion() {
+    return versionOf('footprintjs', ['footprintjs/package.json']);
+}
+//# sourceMappingURL=libraryVersion.js.map

package/dist/esm/lib/libraryVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libraryVersion.js","sourceRoot":"","sources":["../../../src/lib/libraryVersion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,SAAS,SAAS,CAAC,WAAmB,EAAE,UAA6B;IACnE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAsC,SAAS,CAAC,CAAC;YACxE,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,CAAC,gBAAgB,EAAE;QACjC,6BAA6B;QAC7B,oBAAoB;QACpB,uBAAuB;KACxB,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,aAAa,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/esm/lib/trace-toolpack/openRecording.d.ts

@@ -50,6 +50,22 @@ export interface OpenableRecording {
     readonly events?: readonly unknown[];
     readonly structure?: unknown;
 }
+/** A recorder row as it rides `snapshot.recorders`. */
+interface RecorderRow {
+    readonly id?: string;
+    readonly name?: string;
+    readonly data?: unknown;
+}
+/**
+ * The narrative recorder's row: `data` is an array of `{ text, depth }`.
+ *
+ * @internal Exported for the bug-report bundler, which writes the same lines to
+ * `narrative.txt`. One shape-detector, one answer to "is there a narrative in
+ * this snapshot?" — two copies would disagree the first time the row changes.
+ */
+export declare function narrativeFrom(snapshot: {
+    recorders?: readonly RecorderRow[];
+}): string[] | undefined;
 /**
  * Reopen a saved recording as toolpack artifacts.
  *
@@ -62,3 +78,4 @@ export interface OpenableRecording {
  *         never be given by mistake.
  */
 export declare function openRecording(recording: OpenableRecording): TraceToolpackArtifacts;
+export {};

package/dist/esm/lib/trace-toolpack/openRecording.js

@@ -38,8 +38,14 @@
  * toolpack navigates what a run DID, and the chart says what it COULD do.
  * It is left on the recording for the viewers that draw it.
  */
-/** The narrative recorder's row: `data` is an array of `{ text, depth }`. */
-function narrativeFrom(snapshot) {
+/**
+ * The narrative recorder's row: `data` is an array of `{ text, depth }`.
+ *
+ * @internal Exported for the bug-report bundler, which writes the same lines to
+ * `narrative.txt`. One shape-detector, one answer to "is there a narrative in
+ * this snapshot?" — two copies would disagree the first time the row changes.
+ */
+export function narrativeFrom(snapshot) {
     const rows = snapshot.recorders;
     if (!Array.isArray(rows))
         return undefined;

package/dist/esm/lib/trace-toolpack/openRecording.js.map

@@ -1 +1 @@
-{"version":3,"file":"openRecording.js","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/openRecording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AA0BH,6EAA6E;AAC7E,SAAS,aAAa,CAAC,QAAgD;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACxD,0EAA0E;QAC1E,yEAAyE;QACzE,2CAA2C;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAoD,CAAC;QACzE,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClF,OAAQ,IAA6B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAClD,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,SAA4B;IACxD,MAAM,QAAQ,GAAG,SAAS,EAAE,QAEf,CAAC;IAEd,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,gEAAgE;YAC9D,sFAAsF;YACtF,gFAAgF;YAChF,qFAAqF;YACrF,6DAA6D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG;YACd,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAC3D,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;SACnE;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,4DAA4D,OAAO,qBAAqB;YACtF,4EAA4E;YAC5E,sFAAsF;YACtF,oFAAoF;YACpF,wEAAwE;YACxE,qCAAqC,CACxC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAChC,OAAO;QACL,QAAQ;QACR,oEAAoE;QACpE,qEAAqE;QACrE,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAwC,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"openRecording.js","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/openRecording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AA0BH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAE7B;IACC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACxD,0EAA0E;QAC1E,yEAAyE;QACzE,2CAA2C;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAoD,CAAC;QACzE,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClF,OAAQ,IAA6B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAClD,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,SAA4B;IACxD,MAAM,QAAQ,GAAG,SAAS,EAAE,QAEf,CAAC;IAEd,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,gEAAgE;YAC9D,sFAAsF;YACtF,gFAAgF;YAChF,qFAAqF;YACrF,6DAA6D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG;YACd,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAC3D,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;SACnE;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,4DAA4D,OAAO,qBAAqB;YACtF,4EAA4E;YAC5E,sFAAsF;YACtF,oFAAoF;YACpF,wEAAwE;YACxE,qCAAqC,CACxC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAChC,OAAO;QACL,QAAQ;QACR,oEAAoE;QACpE,qEAAqE;QACrE,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAwC,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/esm/observability-providers.d.ts

@@ -51,3 +51,5 @@ export { otelObservability, type OtelObservabilityOptions, type OtelObservabilit
 export { fileObservability, type FileObservabilityOptions, type FileSinkFs, } from './adapters/observability/file.js';
 export { auditExport, verifyAuditBundle, AUDIT_BUNDLE_FORMAT, AUDIT_GENESIS_EVENT_TYPE, AUDIT_ZERO_HASH, type AuditBundle, type AuditBundleHeader, type AuditExportOptions, type AuditExportStrategy, type AuditRecord, type AuditVerifyResult, } from './adapters/observability/audit.js';
 export { canonicalJson, CANONICAL_JSON_VERSION } from './lib/canonicalJson.js';
+export { githubBugReporter, type BugReporter, type FiledBugReport, type GithubBugReporterOptions, } from './adapters/observability/githubBugReporter.js';
+export { githubDeviceSignIn, type GithubDeviceIdentity, type GithubDeviceSignIn, type GithubDeviceSignInOptions, } from './adapters/observability/githubDeviceSignIn.js';

package/dist/esm/observability-providers.js

@@ -57,4 +57,13 @@ export { fileObservability, } from './adapters/observability/file.js';
 // imported the same way the vendor SDKs are).
 export { auditExport, verifyAuditBundle, AUDIT_BUNDLE_FORMAT, AUDIT_GENESIS_EVENT_TYPE, AUDIT_ZERO_HASH, } from './adapters/observability/audit.js';
 export { canonicalJson, CANONICAL_JSON_VERSION } from './lib/canonicalJson.js';
+// File a bug report WITH the run attached (9.9.0). Two vendor-free adapters
+// over plain `fetch` — no SDK, `apiBase` for GitHub Enterprise Server, and a
+// `_fetch` seam so the whole path is testable without a network:
+//   • `githubBugReporter` — commits the evidence zip and files the issue.
+//     TWIN TARGETS: the issue and the evidence may live in different repos.
+//   • `githubDeviceSignIn` — the reporter signs in as themselves, so the issue
+//     carries their name (OAuth device flow; browser-safe).
+export { githubBugReporter, } from './adapters/observability/githubBugReporter.js';
+export { githubDeviceSignIn, } from './adapters/observability/githubDeviceSignIn.js';
 //# sourceMappingURL=observability-providers.js.map

package/dist/esm/observability-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../../src/observability-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,uBAAuB,GAExB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,GAQlB,MAAM,kCAAkC,CAAC;AAC1C,qEAAqE;AACrE,yEAAyE;AACzE,wEAAwE;AACxE,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAC1C,sEAAsE;AACtE,sEAAsE;AACtE,8CAA8C;AAC9C,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,GAOhB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../../src/observability-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,uBAAuB,GAExB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,GAQlB,MAAM,kCAAkC,CAAC;AAC1C,qEAAqE;AACrE,yEAAyE;AACzE,wEAAwE;AACxE,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAC1C,sEAAsE;AACtE,sEAAsE;AACtE,8CAA8C;AAC9C,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,GAOhB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,4EAA4E;AAC5E,6EAA6E;AAC7E,iEAAiE;AACjE,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,4DAA4D;AAC5D,OAAO,EACL,iBAAiB,GAIlB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,kBAAkB,GAInB,MAAM,gDAAgD,CAAC"}

package/dist/esm/observe.d.ts

@@ -39,6 +39,7 @@ export { boundaryRecorder, BoundaryRecorder, type ActorArrow, type BoundaryAggre
 export { buildRunSteps, RunStepRecorder, runStepRecorder, type BuildRunStepsOptions, type RunStep, type RunStepGraph, type RunStepKind, type RunStepMeta, type RunStepRecorderOptions, type RunStepTransition, } from './recorders/observability/RunStepRecorder.js';
 export { attachFlowchart, buildStepGraph, buildStepGraphFromEvents, type StepGraph, type StepNode, type StepEdge, type SlotBoundary, type ContextInjection, type FlowchartOptions, type FlowchartHandle, } from './recorders/observability/FlowchartRecorder.js';
 export { recordRun, type Recording, type RecordRunOptions, type RunRecorder, } from './recorders/observability/recordRun.js';
+export { describeBugReport, exportBugReport, type BugReport, type BugReportEnvironment, type BugReportExcluded, type BugReportFields, type BugReportFile, type BugReportFileSummary, type BugReportInput, type BugReportManifest, type BugReportOversize, type BugReportSource, type BugReportUnit, type DescribeBugReportOptions, type ExportBugReportOptions, type Transcript, type TranscriptStep, type TranscriptTurn, } from './lib/bug-report/index.js';
 export { summarizeEmbeddings, summarizeVector, type EmbeddingSummary, } from './recorders/observability/embeddingSummary.js';
 export { serializeTrace, redactContent, traceToStepGraph, type Trace, type TraceSummary, type TraceRedaction, type SerializeTraceOptions, } from './recorders/observability/trace.js';
 export { attachLocalObservability, type LocalObservabilityHandle, type LocalObservabilityOptions, } from './recorders/observability/localObservability.js';

package/dist/esm/observe.js

@@ -45,6 +45,12 @@ export { attachFlowchart, buildStepGraph, buildStepGraphFromEvents, } from './re
 // which is the shape the UIs consume (lens's `observeRecording`) and the one
 // every integration used to assemble by hand, each missing a different piece.
 export { recordRun, } from './recorders/observability/recordRun.js';
+// exportBugReport — a bug report IS the evidence. `describeBugReport` measures
+// the run first (selectable units, sizes, the redacted keys by NAME) so a human
+// can consent to exactly what leaves; `exportBugReport` bundles the units they
+// kept as named files plus a real (stored) zip. `githubBugReporter` — in this
+// same door, from the providers barrel — files that bundle.
+export { describeBugReport, exportBugReport, } from './lib/bug-report/index.js';
 // What a recording keeps of a vector: `{ dims, norm }`, not the bytes (8.20.0).
 // Applied by BoundaryRecorder and recordRun unless `recordEmbeddings: true`;
 // exported so consumers that render or post-process recordings can apply or

package/dist/esm/observe.js.map

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