@ai-agent-forge/agent-forge 0.85.0

package/dist/artifacts/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/artifacts/artifact-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;KAC3B,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;KAAE,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG;QACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;KAC3B,CAAC;IACF,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAAC;IACnD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;CACrF;AAyBD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,eAAe,CA8DlG","sourcesContent":["/**\n * Artifact store (2.6a) — session export artifacts with refs, a bounded\n * read boundary, and an explicit end-of-life.\n *\n * Writers store bytes once and hand out serializable refs (id, session,\n * operation, kind, media type, size). Readers get the bytes only through\n * `read`, which is scoped to the owning session; `stat` exposes metadata\n * only. `endLifecycle` terminates an artifact explicitly: later reads fail\n * with a structured `ended` error and stats report the terminal state —\n * nothing is silently deleted or silently kept alive. Renderers and share\n * transports belong to later slices (2.6b-d).\n */\nimport type { ArtifactRefV1 } from \"../core/agent-capability-contract.ts\";\n\nexport type { ArtifactRefV1 };\n\nexport interface ArtifactStatV1 {\n\treadonly artifactId: string;\n\treadonly sessionId: string;\n\treadonly operationId: string;\n\treadonly kind: string;\n\treadonly mediaType: string;\n\treadonly sizeBytes?: number;\n\treadonly state: \"available\" | \"ended\";\n\treadonly endReason?: string;\n}\n\nexport interface ArtifactStoreV1 {\n\twrite(input: {\n\t\treadonly sessionId: string;\n\t\treadonly operationId: string;\n\t\treadonly kind: string;\n\t\treadonly mediaType: string;\n\t\treadonly bytes: Uint8Array;\n\t}): { readonly ref: ArtifactRefV1 };\n\tread(input: { readonly artifactId: string; readonly sessionId: string }): {\n\t\treadonly mediaType: string;\n\t\treadonly bytes: Uint8Array;\n\t};\n\tstat(artifactId: string): ArtifactStatV1 | undefined;\n\tlist(sessionId: string): readonly ArtifactStatV1[];\n\tendLifecycle(artifactId: string, input: { readonly reason: string }): ArtifactStatV1;\n}\n\n/** FNV-1a 32-bit over the artifact content — deterministic artifact ids. */\nfunction contentHash(bytes: Uint8Array): string {\n\tlet hash = 0x811c9dc5;\n\tfor (const byte of bytes) {\n\t\thash ^= byte;\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn (hash >>> 0).toString(36);\n}\n\nfunction toStat(entry: { ref: ArtifactRefV1; bytes: Uint8Array; ended: boolean; endReason?: string }): ArtifactStatV1 {\n\treturn {\n\t\tartifactId: entry.ref.artifactId,\n\t\tsessionId: entry.ref.sessionId,\n\t\toperationId: entry.ref.operationId,\n\t\tkind: entry.ref.kind,\n\t\tmediaType: entry.ref.mediaType,\n\t\tsizeBytes: entry.ref.sizeBytes,\n\t\tstate: entry.ended ? \"ended\" : \"available\",\n\t\t...(entry.ended ? { endReason: entry.endReason } : {}),\n\t};\n}\n\nexport function createArtifactStore(options: { readonly now?: () => number } = {}): ArtifactStoreV1 {\n\tconst now = options.now ?? (() => Date.now());\n\tconst artifacts = new Map<string, { ref: ArtifactRefV1; bytes: Uint8Array; ended: boolean; endReason?: string }>();\n\tconst sequenceByIdentity = new Map<string, number>();\n\t// Global write counter: guarantees artifact ids are unique across ALL\n\t// (session, operation) identities — identical bytes written by two\n\t// different identities must never collide into one id.\n\tlet globalWriteSequence = 0;\n\n\treturn {\n\t\twrite(input) {\n\t\t\tif (input.bytes.length === 0) throw new Error(\"Artifact bytes must not be empty\");\n\t\t\tconst identity = `${input.sessionId}\\u0000${input.operationId}`;\n\t\t\tconst sequence = (sequenceByIdentity.get(identity) ?? 0) + 1;\n\t\t\tsequenceByIdentity.set(identity, sequence);\n\t\t\tglobalWriteSequence += 1;\n\t\t\tconst artifactId = `art-${contentHash(input.bytes)}-${sequence}-${globalWriteSequence}`;\n\t\t\tconst ref: ArtifactRefV1 = {\n\t\t\t\tartifactId,\n\t\t\t\tsessionId: input.sessionId,\n\t\t\t\toperationId: input.operationId,\n\t\t\t\tkind: input.kind,\n\t\t\t\tmediaType: input.mediaType,\n\t\t\t\tsizeBytes: input.bytes.length,\n\t\t\t\ttruncated: false,\n\t\t\t\tcreatedAt: now(),\n\t\t\t};\n\t\t\tartifacts.set(artifactId, { ref, bytes: input.bytes, ended: false });\n\t\t\treturn { ref };\n\t\t},\n\t\tread(input) {\n\t\t\tconst entry = artifacts.get(input.artifactId);\n\t\t\tif (!entry) throw new Error(`Artifact not found: ${input.artifactId}`);\n\t\t\tif (entry.ref.sessionId !== input.sessionId) {\n\t\t\t\tthrow new Error(`Artifact ${input.artifactId} belongs to a different session`);\n\t\t\t}\n\t\t\tif (entry.ended) {\n\t\t\t\tthrow new Error(`Artifact ${input.artifactId} lifecycle has ended: ${entry.endReason ?? \"ended\"}`);\n\t\t\t}\n\t\t\treturn { mediaType: entry.ref.mediaType, bytes: entry.bytes };\n\t\t},\n\t\tstat(artifactId) {\n\t\t\tconst entry = artifacts.get(artifactId);\n\t\t\treturn entry === undefined ? undefined : toStat(entry);\n\t\t},\n\t\tlist(sessionId) {\n\t\t\treturn [...artifacts.values()]\n\t\t\t\t.filter((entry) => entry.ref.sessionId === sessionId)\n\t\t\t\t.map((entry) => toStat(entry));\n\t\t},\n\t\tendLifecycle(artifactId, input) {\n\t\t\tconst entry = artifacts.get(artifactId);\n\t\t\tif (!entry) throw new Error(`Artifact not found: ${artifactId}`);\n\t\t\tif (entry.ended) {\n\t\t\t\tthrow new Error(`Artifact ${artifactId} lifecycle has already ended`);\n\t\t\t}\n\t\t\tentry.ended = true;\n\t\t\tentry.endReason = input.reason;\n\t\t\tentry.bytes = new Uint8Array(0);\n\t\t\treturn toStat(entry);\n\t\t},\n\t};\n}\n"]}

package/dist/artifacts/artifact-store.js

@@ -0,0 +1,87 @@
+/** FNV-1a 32-bit over the artifact content — deterministic artifact ids. */
+function contentHash(bytes) {
+    let hash = 0x811c9dc5;
+    for (const byte of bytes) {
+        hash ^= byte;
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+function toStat(entry) {
+    return {
+        artifactId: entry.ref.artifactId,
+        sessionId: entry.ref.sessionId,
+        operationId: entry.ref.operationId,
+        kind: entry.ref.kind,
+        mediaType: entry.ref.mediaType,
+        sizeBytes: entry.ref.sizeBytes,
+        state: entry.ended ? "ended" : "available",
+        ...(entry.ended ? { endReason: entry.endReason } : {}),
+    };
+}
+export function createArtifactStore(options = {}) {
+    const now = options.now ?? (() => Date.now());
+    const artifacts = new Map();
+    const sequenceByIdentity = new Map();
+    // Global write counter: guarantees artifact ids are unique across ALL
+    // (session, operation) identities — identical bytes written by two
+    // different identities must never collide into one id.
+    let globalWriteSequence = 0;
+    return {
+        write(input) {
+            if (input.bytes.length === 0)
+                throw new Error("Artifact bytes must not be empty");
+            const identity = `${input.sessionId}\u0000${input.operationId}`;
+            const sequence = (sequenceByIdentity.get(identity) ?? 0) + 1;
+            sequenceByIdentity.set(identity, sequence);
+            globalWriteSequence += 1;
+            const artifactId = `art-${contentHash(input.bytes)}-${sequence}-${globalWriteSequence}`;
+            const ref = {
+                artifactId,
+                sessionId: input.sessionId,
+                operationId: input.operationId,
+                kind: input.kind,
+                mediaType: input.mediaType,
+                sizeBytes: input.bytes.length,
+                truncated: false,
+                createdAt: now(),
+            };
+            artifacts.set(artifactId, { ref, bytes: input.bytes, ended: false });
+            return { ref };
+        },
+        read(input) {
+            const entry = artifacts.get(input.artifactId);
+            if (!entry)
+                throw new Error(`Artifact not found: ${input.artifactId}`);
+            if (entry.ref.sessionId !== input.sessionId) {
+                throw new Error(`Artifact ${input.artifactId} belongs to a different session`);
+            }
+            if (entry.ended) {
+                throw new Error(`Artifact ${input.artifactId} lifecycle has ended: ${entry.endReason ?? "ended"}`);
+            }
+            return { mediaType: entry.ref.mediaType, bytes: entry.bytes };
+        },
+        stat(artifactId) {
+            const entry = artifacts.get(artifactId);
+            return entry === undefined ? undefined : toStat(entry);
+        },
+        list(sessionId) {
+            return [...artifacts.values()]
+                .filter((entry) => entry.ref.sessionId === sessionId)
+                .map((entry) => toStat(entry));
+        },
+        endLifecycle(artifactId, input) {
+            const entry = artifacts.get(artifactId);
+            if (!entry)
+                throw new Error(`Artifact not found: ${artifactId}`);
+            if (entry.ended) {
+                throw new Error(`Artifact ${artifactId} lifecycle has already ended`);
+            }
+            entry.ended = true;
+            entry.endReason = input.reason;
+            entry.bytes = new Uint8Array(0);
+            return toStat(entry);
+        },
+    };
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/artifacts/artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../src/artifacts/artifact-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Artifact store (2.6a) — session export artifacts with refs, a bounded\n * read boundary, and an explicit end-of-life.\n *\n * Writers store bytes once and hand out serializable refs (id, session,\n * operation, kind, media type, size). Readers get the bytes only through\n * `read`, which is scoped to the owning session; `stat` exposes metadata\n * only. `endLifecycle` terminates an artifact explicitly: later reads fail\n * with a structured `ended` error and stats report the terminal state —\n * nothing is silently deleted or silently kept alive. Renderers and share\n * transports belong to later slices (2.6b-d).\n */\nimport type { ArtifactRefV1 } from \"../core/agent-capability-contract.ts\";\n\nexport type { ArtifactRefV1 };\n\nexport interface ArtifactStatV1 {\n\treadonly artifactId: string;\n\treadonly sessionId: string;\n\treadonly operationId: string;\n\treadonly kind: string;\n\treadonly mediaType: string;\n\treadonly sizeBytes?: number;\n\treadonly state: \"available\" | \"ended\";\n\treadonly endReason?: string;\n}\n\nexport interface ArtifactStoreV1 {\n\twrite(input: {\n\t\treadonly sessionId: string;\n\t\treadonly operationId: string;\n\t\treadonly kind: string;\n\t\treadonly mediaType: string;\n\t\treadonly bytes: Uint8Array;\n\t}): { readonly ref: ArtifactRefV1 };\n\tread(input: { readonly artifactId: string; readonly sessionId: string }): {\n\t\treadonly mediaType: string;\n\t\treadonly bytes: Uint8Array;\n\t};\n\tstat(artifactId: string): ArtifactStatV1 | undefined;\n\tlist(sessionId: string): readonly ArtifactStatV1[];\n\tendLifecycle(artifactId: string, input: { readonly reason: string }): ArtifactStatV1;\n}\n\n/** FNV-1a 32-bit over the artifact content — deterministic artifact ids. */\nfunction contentHash(bytes: Uint8Array): string {\n\tlet hash = 0x811c9dc5;\n\tfor (const byte of bytes) {\n\t\thash ^= byte;\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn (hash >>> 0).toString(36);\n}\n\nfunction toStat(entry: { ref: ArtifactRefV1; bytes: Uint8Array; ended: boolean; endReason?: string }): ArtifactStatV1 {\n\treturn {\n\t\tartifactId: entry.ref.artifactId,\n\t\tsessionId: entry.ref.sessionId,\n\t\toperationId: entry.ref.operationId,\n\t\tkind: entry.ref.kind,\n\t\tmediaType: entry.ref.mediaType,\n\t\tsizeBytes: entry.ref.sizeBytes,\n\t\tstate: entry.ended ? \"ended\" : \"available\",\n\t\t...(entry.ended ? { endReason: entry.endReason } : {}),\n\t};\n}\n\nexport function createArtifactStore(options: { readonly now?: () => number } = {}): ArtifactStoreV1 {\n\tconst now = options.now ?? (() => Date.now());\n\tconst artifacts = new Map<string, { ref: ArtifactRefV1; bytes: Uint8Array; ended: boolean; endReason?: string }>();\n\tconst sequenceByIdentity = new Map<string, number>();\n\t// Global write counter: guarantees artifact ids are unique across ALL\n\t// (session, operation) identities — identical bytes written by two\n\t// different identities must never collide into one id.\n\tlet globalWriteSequence = 0;\n\n\treturn {\n\t\twrite(input) {\n\t\t\tif (input.bytes.length === 0) throw new Error(\"Artifact bytes must not be empty\");\n\t\t\tconst identity = `${input.sessionId}\\u0000${input.operationId}`;\n\t\t\tconst sequence = (sequenceByIdentity.get(identity) ?? 0) + 1;\n\t\t\tsequenceByIdentity.set(identity, sequence);\n\t\t\tglobalWriteSequence += 1;\n\t\t\tconst artifactId = `art-${contentHash(input.bytes)}-${sequence}-${globalWriteSequence}`;\n\t\t\tconst ref: ArtifactRefV1 = {\n\t\t\t\tartifactId,\n\t\t\t\tsessionId: input.sessionId,\n\t\t\t\toperationId: input.operationId,\n\t\t\t\tkind: input.kind,\n\t\t\t\tmediaType: input.mediaType,\n\t\t\t\tsizeBytes: input.bytes.length,\n\t\t\t\ttruncated: false,\n\t\t\t\tcreatedAt: now(),\n\t\t\t};\n\t\t\tartifacts.set(artifactId, { ref, bytes: input.bytes, ended: false });\n\t\t\treturn { ref };\n\t\t},\n\t\tread(input) {\n\t\t\tconst entry = artifacts.get(input.artifactId);\n\t\t\tif (!entry) throw new Error(`Artifact not found: ${input.artifactId}`);\n\t\t\tif (entry.ref.sessionId !== input.sessionId) {\n\t\t\t\tthrow new Error(`Artifact ${input.artifactId} belongs to a different session`);\n\t\t\t}\n\t\t\tif (entry.ended) {\n\t\t\t\tthrow new Error(`Artifact ${input.artifactId} lifecycle has ended: ${entry.endReason ?? \"ended\"}`);\n\t\t\t}\n\t\t\treturn { mediaType: entry.ref.mediaType, bytes: entry.bytes };\n\t\t},\n\t\tstat(artifactId) {\n\t\t\tconst entry = artifacts.get(artifactId);\n\t\t\treturn entry === undefined ? undefined : toStat(entry);\n\t\t},\n\t\tlist(sessionId) {\n\t\t\treturn [...artifacts.values()]\n\t\t\t\t.filter((entry) => entry.ref.sessionId === sessionId)\n\t\t\t\t.map((entry) => toStat(entry));\n\t\t},\n\t\tendLifecycle(artifactId, input) {\n\t\t\tconst entry = artifacts.get(artifactId);\n\t\t\tif (!entry) throw new Error(`Artifact not found: ${artifactId}`);\n\t\t\tif (entry.ended) {\n\t\t\t\tthrow new Error(`Artifact ${artifactId} lifecycle has already ended`);\n\t\t\t}\n\t\t\tentry.ended = true;\n\t\t\tentry.endReason = input.reason;\n\t\t\tentry.bytes = new Uint8Array(0);\n\t\t\treturn toStat(entry);\n\t\t},\n\t};\n}\n"]}

package/dist/artifacts/paged-read.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Paged artifact reading (3.5c) — expands large artifacts through reference
+ * pages instead of one unbounded read.
+ *
+ * `planArtifactPages` derives a deterministic page directory from the
+ * artifact's stat size; `readArtifactPage` serves one page by slicing the
+ * 2.6a store's read. Every unavailability (ended lifecycle, cross-session
+ * read, unknown id, invalid page size) is a structured `unavailable`
+ * result — never a crash and never a silent empty page. No new Agent
+ * business API is introduced; the 2.6a store remains the only bytes source.
+ */
+import type { ArtifactStoreV1 } from "./artifact-store.ts";
+export interface ArtifactPageDirectoryEntryV1 {
+    readonly index: number;
+    readonly offset: number;
+    readonly size: number;
+}
+export type ArtifactPagePlanV1 = {
+    readonly status: "planned";
+    readonly totalBytes: number;
+    readonly pageSize: number;
+    readonly pages: readonly ArtifactPageDirectoryEntryV1[];
+} | {
+    readonly status: "invalid_page_size";
+    readonly pageSize: number;
+} | {
+    readonly status: "unavailable";
+    readonly reason: string;
+};
+export type ArtifactPageReadV1 = {
+    readonly status: "ok";
+    readonly index: number;
+    readonly offset: number;
+    readonly bytes: Uint8Array;
+    readonly hasMore: boolean;
+    readonly nextOffset?: number;
+} | {
+    readonly status: "unavailable";
+    readonly reason: string;
+};
+export declare function planArtifactPages(store: Pick<ArtifactStoreV1, "stat">, input: {
+    readonly artifactId: string;
+    readonly pageSize: number;
+}): ArtifactPagePlanV1;
+export declare function readArtifactPage(store: Pick<ArtifactStoreV1, "read" | "stat">, input: {
+    readonly artifactId: string;
+    readonly sessionId: string;
+    readonly index: number;
+    readonly pageSize: number;
+}): ArtifactPageReadV1;
+//# sourceMappingURL=paged-read.d.ts.map

package/dist/artifacts/paged-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paged-read.d.ts","sourceRoot":"","sources":["../../src/artifacts/paged-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC3B;IACA,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACvD,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAC3B;IACA,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC5B,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACpC,KAAK,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/D,kBAAkB,CAkBpB;AAED,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,EAC7C,KAAK,EAAE;IACN,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B,GACC,kBAAkB,CAgCpB","sourcesContent":["/**\n * Paged artifact reading (3.5c) — expands large artifacts through reference\n * pages instead of one unbounded read.\n *\n * `planArtifactPages` derives a deterministic page directory from the\n * artifact's stat size; `readArtifactPage` serves one page by slicing the\n * 2.6a store's read. Every unavailability (ended lifecycle, cross-session\n * read, unknown id, invalid page size) is a structured `unavailable`\n * result — never a crash and never a silent empty page. No new Agent\n * business API is introduced; the 2.6a store remains the only bytes source.\n */\nimport type { ArtifactStoreV1 } from \"./artifact-store.ts\";\n\nexport interface ArtifactPageDirectoryEntryV1 {\n\treadonly index: number;\n\treadonly offset: number;\n\treadonly size: number;\n}\n\nexport type ArtifactPagePlanV1 =\n\t| {\n\t\t\treadonly status: \"planned\";\n\t\t\treadonly totalBytes: number;\n\t\t\treadonly pageSize: number;\n\t\t\treadonly pages: readonly ArtifactPageDirectoryEntryV1[];\n\t  }\n\t| { readonly status: \"invalid_page_size\"; readonly pageSize: number }\n\t| { readonly status: \"unavailable\"; readonly reason: string };\n\nexport type ArtifactPageReadV1 =\n\t| {\n\t\t\treadonly status: \"ok\";\n\t\t\treadonly index: number;\n\t\t\treadonly offset: number;\n\t\t\treadonly bytes: Uint8Array;\n\t\t\treadonly hasMore: boolean;\n\t\t\treadonly nextOffset?: number;\n\t  }\n\t| { readonly status: \"unavailable\"; readonly reason: string };\n\nexport function planArtifactPages(\n\tstore: Pick<ArtifactStoreV1, \"stat\">,\n\tinput: { readonly artifactId: string; readonly pageSize: number },\n): ArtifactPagePlanV1 {\n\tif (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {\n\t\treturn { status: \"invalid_page_size\", pageSize: input.pageSize };\n\t}\n\tconst stat = store.stat(input.artifactId);\n\tif (!stat) return { status: \"unavailable\", reason: `Artifact not found: ${input.artifactId}` };\n\tif (stat.state === \"ended\") {\n\t\treturn {\n\t\t\tstatus: \"unavailable\",\n\t\t\treason: `Artifact ${input.artifactId} lifecycle has ended: ${stat.endReason ?? \"ended\"}`,\n\t\t};\n\t}\n\tconst totalBytes = stat.sizeBytes ?? 0;\n\tconst pages: ArtifactPageDirectoryEntryV1[] = [];\n\tfor (let offset = 0; offset < totalBytes; offset += input.pageSize) {\n\t\tpages.push({ index: pages.length, offset, size: Math.min(input.pageSize, totalBytes - offset) });\n\t}\n\treturn { status: \"planned\", totalBytes, pageSize: input.pageSize, pages: Object.freeze(pages) };\n}\n\nexport function readArtifactPage(\n\tstore: Pick<ArtifactStoreV1, \"read\" | \"stat\">,\n\tinput: {\n\t\treadonly artifactId: string;\n\t\treadonly sessionId: string;\n\t\treadonly index: number;\n\t\treadonly pageSize: number;\n\t},\n): ArtifactPageReadV1 {\n\tif (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {\n\t\treturn { status: \"unavailable\", reason: `Invalid page size: ${input.pageSize}` };\n\t}\n\tconst plan = planArtifactPages(store, { artifactId: input.artifactId, pageSize: input.pageSize });\n\tif (plan.status !== \"planned\")\n\t\treturn {\n\t\t\tstatus: \"unavailable\",\n\t\t\t// v8 ignore next -- pageSize 已在入口校验，plan 不可能返回 invalid_page_size\n\t\t\treason: plan.status === \"unavailable\" ? plan.reason : `Invalid page size: ${plan.pageSize}`,\n\t\t};\n\tconst page = plan.pages[input.index];\n\tif (!page) {\n\t\treturn { status: \"unavailable\", reason: `Page ${input.index} is outside the plan (${plan.pages.length} pages)` };\n\t}\n\tlet bytes: Uint8Array;\n\ttry {\n\t\tbytes = store.read({ artifactId: input.artifactId, sessionId: input.sessionId }).bytes;\n\t} catch (error) {\n\t\treturn { status: \"unavailable\", reason: error instanceof Error ? error.message : String(error) };\n\t}\n\tconst slice = bytes.slice(page.offset, page.offset + page.size);\n\tconst nextOffset = page.offset + page.size;\n\tconst hasMore = nextOffset < plan.totalBytes;\n\treturn {\n\t\tstatus: \"ok\",\n\t\tindex: page.index,\n\t\toffset: page.offset,\n\t\tbytes: slice,\n\t\thasMore,\n\t\t...(hasMore ? { nextOffset } : {}),\n\t};\n}\n"]}

package/dist/artifacts/paged-read.js

@@ -0,0 +1,55 @@
+export function planArtifactPages(store, input) {
+    if (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {
+        return { status: "invalid_page_size", pageSize: input.pageSize };
+    }
+    const stat = store.stat(input.artifactId);
+    if (!stat)
+        return { status: "unavailable", reason: `Artifact not found: ${input.artifactId}` };
+    if (stat.state === "ended") {
+        return {
+            status: "unavailable",
+            reason: `Artifact ${input.artifactId} lifecycle has ended: ${stat.endReason ?? "ended"}`,
+        };
+    }
+    const totalBytes = stat.sizeBytes ?? 0;
+    const pages = [];
+    for (let offset = 0; offset < totalBytes; offset += input.pageSize) {
+        pages.push({ index: pages.length, offset, size: Math.min(input.pageSize, totalBytes - offset) });
+    }
+    return { status: "planned", totalBytes, pageSize: input.pageSize, pages: Object.freeze(pages) };
+}
+export function readArtifactPage(store, input) {
+    if (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {
+        return { status: "unavailable", reason: `Invalid page size: ${input.pageSize}` };
+    }
+    const plan = planArtifactPages(store, { artifactId: input.artifactId, pageSize: input.pageSize });
+    if (plan.status !== "planned")
+        return {
+            status: "unavailable",
+            // v8 ignore next -- pageSize 已在入口校验，plan 不可能返回 invalid_page_size
+            reason: plan.status === "unavailable" ? plan.reason : `Invalid page size: ${plan.pageSize}`,
+        };
+    const page = plan.pages[input.index];
+    if (!page) {
+        return { status: "unavailable", reason: `Page ${input.index} is outside the plan (${plan.pages.length} pages)` };
+    }
+    let bytes;
+    try {
+        bytes = store.read({ artifactId: input.artifactId, sessionId: input.sessionId }).bytes;
+    }
+    catch (error) {
+        return { status: "unavailable", reason: error instanceof Error ? error.message : String(error) };
+    }
+    const slice = bytes.slice(page.offset, page.offset + page.size);
+    const nextOffset = page.offset + page.size;
+    const hasMore = nextOffset < plan.totalBytes;
+    return {
+        status: "ok",
+        index: page.index,
+        offset: page.offset,
+        bytes: slice,
+        hasMore,
+        ...(hasMore ? { nextOffset } : {}),
+    };
+}
+//# sourceMappingURL=paged-read.js.map

package/dist/artifacts/paged-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paged-read.js","sourceRoot":"","sources":["../../src/artifacts/paged-read.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Paged artifact reading (3.5c) — expands large artifacts through reference\n * pages instead of one unbounded read.\n *\n * `planArtifactPages` derives a deterministic page directory from the\n * artifact's stat size; `readArtifactPage` serves one page by slicing the\n * 2.6a store's read. Every unavailability (ended lifecycle, cross-session\n * read, unknown id, invalid page size) is a structured `unavailable`\n * result — never a crash and never a silent empty page. No new Agent\n * business API is introduced; the 2.6a store remains the only bytes source.\n */\nimport type { ArtifactStoreV1 } from \"./artifact-store.ts\";\n\nexport interface ArtifactPageDirectoryEntryV1 {\n\treadonly index: number;\n\treadonly offset: number;\n\treadonly size: number;\n}\n\nexport type ArtifactPagePlanV1 =\n\t| {\n\t\t\treadonly status: \"planned\";\n\t\t\treadonly totalBytes: number;\n\t\t\treadonly pageSize: number;\n\t\t\treadonly pages: readonly ArtifactPageDirectoryEntryV1[];\n\t  }\n\t| { readonly status: \"invalid_page_size\"; readonly pageSize: number }\n\t| { readonly status: \"unavailable\"; readonly reason: string };\n\nexport type ArtifactPageReadV1 =\n\t| {\n\t\t\treadonly status: \"ok\";\n\t\t\treadonly index: number;\n\t\t\treadonly offset: number;\n\t\t\treadonly bytes: Uint8Array;\n\t\t\treadonly hasMore: boolean;\n\t\t\treadonly nextOffset?: number;\n\t  }\n\t| { readonly status: \"unavailable\"; readonly reason: string };\n\nexport function planArtifactPages(\n\tstore: Pick<ArtifactStoreV1, \"stat\">,\n\tinput: { readonly artifactId: string; readonly pageSize: number },\n): ArtifactPagePlanV1 {\n\tif (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {\n\t\treturn { status: \"invalid_page_size\", pageSize: input.pageSize };\n\t}\n\tconst stat = store.stat(input.artifactId);\n\tif (!stat) return { status: \"unavailable\", reason: `Artifact not found: ${input.artifactId}` };\n\tif (stat.state === \"ended\") {\n\t\treturn {\n\t\t\tstatus: \"unavailable\",\n\t\t\treason: `Artifact ${input.artifactId} lifecycle has ended: ${stat.endReason ?? \"ended\"}`,\n\t\t};\n\t}\n\tconst totalBytes = stat.sizeBytes ?? 0;\n\tconst pages: ArtifactPageDirectoryEntryV1[] = [];\n\tfor (let offset = 0; offset < totalBytes; offset += input.pageSize) {\n\t\tpages.push({ index: pages.length, offset, size: Math.min(input.pageSize, totalBytes - offset) });\n\t}\n\treturn { status: \"planned\", totalBytes, pageSize: input.pageSize, pages: Object.freeze(pages) };\n}\n\nexport function readArtifactPage(\n\tstore: Pick<ArtifactStoreV1, \"read\" | \"stat\">,\n\tinput: {\n\t\treadonly artifactId: string;\n\t\treadonly sessionId: string;\n\t\treadonly index: number;\n\t\treadonly pageSize: number;\n\t},\n): ArtifactPageReadV1 {\n\tif (!Number.isSafeInteger(input.pageSize) || input.pageSize < 1) {\n\t\treturn { status: \"unavailable\", reason: `Invalid page size: ${input.pageSize}` };\n\t}\n\tconst plan = planArtifactPages(store, { artifactId: input.artifactId, pageSize: input.pageSize });\n\tif (plan.status !== \"planned\")\n\t\treturn {\n\t\t\tstatus: \"unavailable\",\n\t\t\t// v8 ignore next -- pageSize 已在入口校验，plan 不可能返回 invalid_page_size\n\t\t\treason: plan.status === \"unavailable\" ? plan.reason : `Invalid page size: ${plan.pageSize}`,\n\t\t};\n\tconst page = plan.pages[input.index];\n\tif (!page) {\n\t\treturn { status: \"unavailable\", reason: `Page ${input.index} is outside the plan (${plan.pages.length} pages)` };\n\t}\n\tlet bytes: Uint8Array;\n\ttry {\n\t\tbytes = store.read({ artifactId: input.artifactId, sessionId: input.sessionId }).bytes;\n\t} catch (error) {\n\t\treturn { status: \"unavailable\", reason: error instanceof Error ? error.message : String(error) };\n\t}\n\tconst slice = bytes.slice(page.offset, page.offset + page.size);\n\tconst nextOffset = page.offset + page.size;\n\tconst hasMore = nextOffset < plan.totalBytes;\n\treturn {\n\t\tstatus: \"ok\",\n\t\tindex: page.index,\n\t\toffset: page.offset,\n\t\tbytes: slice,\n\t\thasMore,\n\t\t...(hasMore ? { nextOffset } : {}),\n\t};\n}\n"]}

package/dist/bun/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bun/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { registerBunOAuthFlows } from \"@agent-forge/ai/bun-oauth\";\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nregisterBunOAuthFlows();\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\nawait import(\"./register-bedrock.ts\");\nawait import(\"../cli.ts\");\n"]}

package/dist/bun/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { registerBunOAuthFlows } from "@agent-forge/ai/bun-oauth";
+import { APP_NAME } from "../config.js";
+process.title = APP_NAME;
+process.emitWarning = (() => { });
+registerBunOAuthFlows();
+import { restoreSandboxEnv } from "./restore-sandbox-env.js";
+restoreSandboxEnv();
+await import("./register-bedrock.js");
+await import("../cli.js");
+//# sourceMappingURL=cli.js.map

package/dist/bun/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAA+B,CAAC;AAE/D,qBAAqB,EAAE,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,iBAAiB,EAAE,CAAC;AAEpB,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACtC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { registerBunOAuthFlows } from \"@agent-forge/ai/bun-oauth\";\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nregisterBunOAuthFlows();\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\nawait import(\"./register-bedrock.ts\");\nawait import(\"../cli.ts\");\n"]}

package/dist/bun/register-bedrock.d.ts

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

package/dist/bun/register-bedrock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.d.ts","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"","sourcesContent":["import { bedrockProviderModule } from \"@agent-forge/ai/bedrock-provider\";\nimport { setBedrockProviderModule } from \"@agent-forge/ai/compat\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/bun/register-bedrock.js

@@ -0,0 +1,4 @@
+import { bedrockProviderModule } from "@agent-forge/ai/bedrock-provider";
+import { setBedrockProviderModule } from "@agent-forge/ai/compat";
+setBedrockProviderModule(bedrockProviderModule);
+//# sourceMappingURL=register-bedrock.js.map

package/dist/bun/register-bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.js","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,wBAAwB,CAAC,qBAAqB,CAAC,CAAC","sourcesContent":["import { bedrockProviderModule } from \"@agent-forge/ai/bedrock-provider\";\nimport { setBedrockProviderModule } from \"@agent-forge/ai/compat\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/bun/restore-sandbox-env.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Workaround for https://github.com/oven-sh/bun/issues/27802
+ *
+ * Bun compiled binaries have an empty `process.env` when running inside
+ * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
+ * the environment from `/proc/self/environ`.
+ *
+ * Keep this in sync with getBunSandboxEnvValue() in
+ * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup
+ * for direct consumers that do not go through this coding-agent entrypoint.
+ */
+/**
+ * Restore environment variables from `/proc/self/environ` when running
+ * inside a sandbox where Bun's `process.env` is empty.
+ */
+export declare function restoreSandboxEnv(): void;
+//# sourceMappingURL=restore-sandbox-env.d.ts.map

package/dist/bun/restore-sandbox-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-sandbox-env.d.ts","sourceRoot":"","sources":["../../src/bun/restore-sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC","sourcesContent":["/**\n * Workaround for https://github.com/oven-sh/bun/issues/27802\n *\n * Bun compiled binaries have an empty `process.env` when running inside\n * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover\n * the environment from `/proc/self/environ`.\n *\n * Keep this in sync with getBunSandboxEnvValue() in\n * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup\n * for direct consumers that do not go through this coding-agent entrypoint.\n */\n\nimport { readFileSync } from \"node:fs\";\n\n/**\n * Restore environment variables from `/proc/self/environ` when running\n * inside a sandbox where Bun's `process.env` is empty.\n */\nexport function restoreSandboxEnv(): void {\n\tif (!process.versions?.bun) return;\n\n\t// If process.env already has entries, nothing to fix.\n\tif (Object.keys(process.env).length > 0) return;\n\n\ttry {\n\t\tconst data = readFileSync(\"/proc/self/environ\", \"utf-8\");\n\t\tfor (const entry of data.split(\"\\0\")) {\n\t\t\tconst idx = entry.indexOf(\"=\");\n\t\t\tif (idx > 0) {\n\t\t\t\tprocess.env[entry.slice(0, idx)] = entry.slice(idx + 1);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// /proc/self/environ may not be readable; ignore.\n\t}\n}\n"]}

package/dist/bun/restore-sandbox-env.js

@@ -0,0 +1,36 @@
+/**
+ * Workaround for https://github.com/oven-sh/bun/issues/27802
+ *
+ * Bun compiled binaries have an empty `process.env` when running inside
+ * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
+ * the environment from `/proc/self/environ`.
+ *
+ * Keep this in sync with getBunSandboxEnvValue() in
+ * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup
+ * for direct consumers that do not go through this coding-agent entrypoint.
+ */
+import { readFileSync } from "node:fs";
+/**
+ * Restore environment variables from `/proc/self/environ` when running
+ * inside a sandbox where Bun's `process.env` is empty.
+ */
+export function restoreSandboxEnv() {
+    if (!process.versions?.bun)
+        return;
+    // If process.env already has entries, nothing to fix.
+    if (Object.keys(process.env).length > 0)
+        return;
+    try {
+        const data = readFileSync("/proc/self/environ", "utf-8");
+        for (const entry of data.split("\0")) {
+            const idx = entry.indexOf("=");
+            if (idx > 0) {
+                process.env[entry.slice(0, idx)] = entry.slice(idx + 1);
+            }
+        }
+    }
+    catch {
+        // /proc/self/environ may not be readable; ignore.
+    }
+}
+//# sourceMappingURL=restore-sandbox-env.js.map

package/dist/bun/restore-sandbox-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-sandbox-env.js","sourceRoot":"","sources":["../../src/bun/restore-sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,GAAS;IACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG;QAAE,OAAO;IAEnC,sDAAsD;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAEhD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,YAAY,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACzD,CAAC;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,kDAAkD;IACnD,CAAC;AAAA,CACD","sourcesContent":["/**\n * Workaround for https://github.com/oven-sh/bun/issues/27802\n *\n * Bun compiled binaries have an empty `process.env` when running inside\n * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover\n * the environment from `/proc/self/environ`.\n *\n * Keep this in sync with getBunSandboxEnvValue() in\n * packages/ai/src/utils/provider-env.ts. The ai package duplicates the lookup\n * for direct consumers that do not go through this coding-agent entrypoint.\n */\n\nimport { readFileSync } from \"node:fs\";\n\n/**\n * Restore environment variables from `/proc/self/environ` when running\n * inside a sandbox where Bun's `process.env` is empty.\n */\nexport function restoreSandboxEnv(): void {\n\tif (!process.versions?.bun) return;\n\n\t// If process.env already has entries, nothing to fix.\n\tif (Object.keys(process.env).length > 0) return;\n\n\ttry {\n\t\tconst data = readFileSync(\"/proc/self/environ\", \"utf-8\");\n\t\tfor (const entry of data.split(\"\\0\")) {\n\t\t\tconst idx = entry.indexOf(\"=\");\n\t\t\tif (idx > 0) {\n\t\t\t\tprocess.env[entry.slice(0, idx)] = entry.slice(idx + 1);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// /proc/self/environ may not be readable; ignore.\n\t}\n}\n"]}