@airprompter/agent-core 0.1.0

package/dist/esm/testing/controlPlane.js

@@ -0,0 +1,341 @@
+/**
+ * A fake control plane for SDK tests: an offline root ceremony, a signing
+ * key, sealed manifests per generation, payloads by hash, an edge pointer —
+ * served through a `fetch` the SDK takes as an option. Signs exactly as the
+ * hosted service does (canonical payload bytes, ES256, P1363).
+ */
+import { generateKeyPairSync } from "node:crypto";
+import { canonicalBytes, sha256Prefixed } from "../protocol/canonicalJson.js";
+import { keyThumbprint, publicJwkOf, releaseDigest, signBytes } from "../protocol/trust.js";
+import { PROTOCOL_VERSION } from "../protocol/version.js";
+/** The protocol version this checkout of the repository declares; manifests the fake signs carry it. */
+export const PROTOCOL = PROTOCOL_VERSION;
+export function newKey() {
+    const { privateKey } = generateKeyPairSync("ec", { namedCurve: "P-256" });
+    const jwk = privateKey.export({ format: "jwk" });
+    return { kty: "EC", crv: "P-256", x: jwk.x, y: jwk.y, d: jwk.d };
+}
+export function rootDocument(input) {
+    const keys = {};
+    const rootId = keyThumbprint(input.rootKey);
+    keys[rootId] = { keyType: "ecdsa-p256", scheme: "ES256", publicKey: publicJwkOf(input.rootKey) };
+    const targetIds = input.signingKeys.map((key) => {
+        const id = keyThumbprint(key);
+        keys[id] = { keyType: "ecdsa-p256", scheme: "ES256", publicKey: publicJwkOf(key) };
+        return id;
+    });
+    const signed = {
+        type: "root",
+        protocol: PROTOCOL,
+        purpose: input.purpose ?? "platform",
+        environment: input.environment,
+        version: input.version ?? 1,
+        expires: input.expires ?? "2027-12-11T00:00:00Z",
+        keys,
+        roles: { root: { keyIds: [rootId], threshold: 1 }, targets: { keyIds: targetIds, threshold: 1 } },
+    };
+    return { signed, signatures: [{ keyId: rootId, alg: "ES256", sig: signBytes(canonicalBytes(signed), input.rootKey) }] };
+}
+export class FakeControlPlane {
+    scope;
+    apiKey;
+    rootKey;
+    signingKey;
+    root;
+    payloads = new Map();
+    requests = [];
+    current = null;
+    generation = 0;
+    edgeEtag = 0;
+    requireCountersign = false;
+    /**
+     * Fresh keys by default (a test). `airprompter dev` (S12) hands in the keys it persisted, so the root a customer
+     * pinned yesterday still verifies today's generations.
+     */
+    constructor(scope, apiKey = "apa_live_testkey", keys = {}) {
+        this.scope = scope;
+        this.apiKey = apiKey;
+        this.rootKey = keys.rootKey ?? newKey();
+        this.signingKey = keys.signingKey ?? newKey();
+        this.root = rootDocument({ rootKey: this.rootKey, signingKeys: [this.signingKey], environment: scope.target });
+    }
+    slot(spec) {
+        const bytes = Buffer.from(spec.text, "utf8");
+        const hash = sha256Prefixed(bytes);
+        this.payloads.set(hash, bytes);
+        const slot = {
+            tag: spec.tag,
+            kind: spec.steps ? "workflow" : "prompt",
+            artifactId: `art_${spec.tag}`,
+            versionId: spec.versionId ?? `ver_${spec.tag}_1`,
+            versionOrdinal: 1,
+            contentHash: hash,
+            byteLength: bytes.length,
+            model: spec.model ?? "claude-sonnet-5",
+            variables: spec.variables ?? [],
+        };
+        if (spec.steps) {
+            slot.steps = spec.steps.map((step, index) => {
+                const stepBytes = Buffer.from(step.text, "utf8");
+                const stepHash = sha256Prefixed(stepBytes);
+                this.payloads.set(stepHash, stepBytes);
+                return { stepId: `${spec.tag}#${index + 1}`, ordinal: index + 1, promptArtifactId: `art_${spec.tag}_${index + 1}`, promptVersionId: step.versionId ?? `ver_${spec.tag}_step${index + 1}`, contentHash: stepHash, byteLength: stepBytes.length };
+            });
+        }
+        return slot;
+    }
+    /** Seal and promote: generation + 1, signed with the signing key. */
+    /** T9: every heartbeat body the fake accepted, and what it answers (a test may change the cadence). */
+    heartbeats = [];
+    heartbeatIntervalSeconds = 300;
+    heartbeatRefusal = null;
+    /**
+     * T26: the grant issuer and a fake S3 behind it. With `grantBaseUrl` set, every accepted heartbeat answers an
+     * `uploadGrant` for the body's instance prefix (or `retryAfterSeconds` while `grantHold` is set); the POST endpoint at
+     * `<grantBaseUrl>/s3/agent-telemetry` checks the policy the way the bucket would and keeps the objects by key.
+     */
+    grantBaseUrl = null;
+    /** S3: a party between the fleet and the edge pins the pointer at this generation; the origin moves on regardless. */
+    pinnedPointer = null;
+    /** S3: whether the heartbeat answer names the origin's generation (an older service does not). */
+    heartbeatLatestGeneration = true;
+    grantTtlMs = 15 * 60 * 1000;
+    grantHold = null;
+    uploadIntervalSeconds = 300;
+    grants = [];
+    objects = new Map();
+    uploads = [];
+    /** A test may fail the next N POSTs (a 500) to exercise backoff. */
+    failNextUploads = 0;
+    /** The issuer's and the bucket's clock (grant expiry, policy expiry); a test drives it beside the uploader's. */
+    now = () => Date.now();
+    grantSeq = 0;
+    issueGrant(instanceId, now) {
+        const grantId = `grant_${String(++this.grantSeq).padStart(4, "0")}_${instanceId.slice(0, 8)}`.replace(/[^A-Za-z0-9_-]/g, "_").padEnd(16, "0");
+        const keyPrefix = `org/${this.scope.organizationId}/agent/${this.scope.agentId}/${this.scope.target}/${instanceId}/`;
+        const expiresAt = new Date(now + this.grantTtlMs).toISOString();
+        const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions: [["starts-with", "$key", keyPrefix], ["content-length-range", 0, 1048576], { "Content-Type": "application/x-ndjson" }, { "x-amz-meta-grant-id": grantId }] })).toString("base64");
+        this.grants.push({ grantId, instanceId, keyPrefix, expiresAt });
+        return {
+            grantId,
+            url: `${this.grantBaseUrl}/s3/agent-telemetry`,
+            fields: { policy, "x-amz-algorithm": "AWS4-HMAC-SHA256", "x-amz-credential": "AKIAFAKE/20260912/eu-west-1/s3/aws4_request", "x-amz-date": "20260912T000000Z", "x-amz-signature": "fake", "x-amz-server-side-encryption": "aws:kms", "x-amz-server-side-encryption-aws-kms-key-id": "arn:aws:kms:eu-west-1:000000000000:key/fake", "x-amz-meta-grant-id": grantId },
+            keyPrefix,
+            expiresAt,
+            maxObjectBytes: 1048576,
+            contentType: "application/x-ndjson",
+        };
+    }
+    /** The bucket's side of a presigned POST: the policy's conditions, the expiry, the size cap; nothing else is looked at. */
+    acceptUpload(init, now) {
+        const contentType = init?.headers?.["content-type"] ?? "";
+        const boundary = /boundary=(.+)$/.exec(contentType)?.[1];
+        if (!boundary || !init?.body)
+            return { status: 400, body: "<Error><Code>MalformedPOSTRequest</Code></Error>" };
+        const raw = typeof init.body === "string" ? Buffer.from(init.body, "utf8") : Buffer.from(init.body);
+        const fields = new Map();
+        const marker = Buffer.from(`--${boundary}`);
+        let offset = raw.indexOf(marker);
+        while (offset !== -1) {
+            const next = raw.indexOf(marker, offset + marker.length);
+            if (next === -1)
+                break;
+            const part = raw.subarray(offset + marker.length + 2, next - 2); // skip CRLF after the marker; drop CRLF before the next
+            const headerEnd = part.indexOf("\r\n\r\n");
+            const headers = part.subarray(0, headerEnd).toString("utf8");
+            const name = /name="([^"]+)"/.exec(headers)?.[1];
+            if (name)
+                fields.set(name, part.subarray(headerEnd + 4));
+            offset = next;
+        }
+        if (this.failNextUploads > 0) {
+            this.failNextUploads -= 1;
+            return { status: 500, body: "<Error><Code>InternalError</Code></Error>" };
+        }
+        const policyText = fields.get("policy")?.toString("utf8");
+        const policy = policyText ? JSON.parse(Buffer.from(policyText, "base64").toString("utf8")) : null;
+        if (!policy)
+            return { status: 403, body: "<Error><Code>AccessDenied</Code><Message>Invalid according to Policy: Policy missing</Message></Error>" };
+        if (Date.parse(policy.expiration) <= now)
+            return { status: 403, body: "<Error><Code>AccessDenied</Code><Message>Invalid according to Policy: Policy expired.</Message></Error>" };
+        const key = fields.get("key")?.toString("utf8") ?? "";
+        const grantId = fields.get("x-amz-meta-grant-id")?.toString("utf8");
+        const grant = this.grants.find((g) => g.grantId === grantId);
+        if (!grant || !key.startsWith(grant.keyPrefix))
+            return { status: 403, body: "<Error><Code>AccessDenied</Code><Message>Invalid according to Policy: Policy Condition failed: [\"starts-with\", \"$key\", ...]</Message></Error>" };
+        if (fields.get("Content-Type")?.toString("utf8") !== "application/x-ndjson")
+            return { status: 403, body: "<Error><Code>AccessDenied</Code><Message>Invalid according to Policy: Content-Type</Message></Error>" };
+        if (fields.get("x-amz-server-side-encryption")?.toString("utf8") !== "aws:kms")
+            return { status: 403, body: "<Error><Code>AccessDenied</Code><Message>Invalid according to Policy: SSE</Message></Error>" };
+        const file = fields.get("file");
+        if (!file)
+            return { status: 400, body: "<Error><Code>InvalidArgument</Code><Message>POST requires exactly one file upload per request.</Message></Error>" };
+        if (file.length > 1048576)
+            return { status: 400, body: "<Error><Code>EntityTooLarge</Code></Error>" };
+        this.objects.set(key, Buffer.from(file));
+        this.uploads.push(key);
+        return { status: 204, body: "" };
+    }
+    promote(slots, options = {}) {
+        const sorted = [...slots].sort((a, b) => (a.tag < b.tag ? -1 : 1));
+        this.generation = options.generation ?? this.generation + 1;
+        const payload = {
+            protocol: PROTOCOL,
+            ...this.scope,
+            generation: this.generation,
+            releaseDigest: releaseDigest(sorted),
+            issuedAt: new Date().toISOString(),
+            leaseSeconds: options.leaseSeconds ?? 3600,
+            onLeaseExpiry: options.onLeaseExpiry ?? "degrade",
+            applyPolicy: options.applyPolicy ?? "auto",
+            ...(options.unlockWindow ? { unlockWindow: options.unlockWindow } : {}),
+            requireCountersign: this.requireCountersign,
+            slots: sorted,
+            ...(options.experiment ? { experiment: options.experiment } : {}),
+            directives: options.directives ?? [],
+        };
+        const signer = options.signWith ?? this.signingKey;
+        const manifest = { payload, signatures: [{ keyId: keyThumbprint(signer), alg: "ES256", sig: signBytes(canonicalBytes(payload), signer) }], countersignatures: [] };
+        const bytes = Buffer.from(JSON.stringify(manifest), "utf8");
+        this.current = { manifest, bytes, etag: sha256Prefixed(bytes) };
+        this.edgeEtag += 1;
+        return manifest;
+    }
+    get manifest() {
+        return this.current?.manifest ?? null;
+    }
+    /** The `fetch` the SDK sees. */
+    fetch() {
+        const respond = (status, body = "", headers = {}) => ({
+            status,
+            headers: { get: (name) => headers[name.toLowerCase()] ?? null },
+            /** Every header, for a test that bridges this fake onto a real HTTP listener. */
+            headerEntries: Object.entries(headers),
+            arrayBuffer: async () => {
+                // A Buffer may be a view into a shared pool: copy exactly its bytes, never the pool.
+                const bytes = typeof body === "string" ? Buffer.from(body, "utf8") : body;
+                return new Uint8Array(bytes).buffer;
+            },
+            text: async () => (typeof body === "string" ? body : body.toString("utf8")),
+        });
+        return async (url, init) => {
+            this.requests.push(url);
+            const auth = init?.headers?.authorization ?? init?.headers?.Authorization;
+            const parsed = new URL(url);
+            if (parsed.pathname.endsWith("/generation.json")) {
+                if (!this.current)
+                    return respond(404);
+                if (this.pinnedPointer) {
+                    // The pinned pointer: the same stale answer, the same ETag, forever.
+                    const pinnedEtag = `"edge-pinned-${this.pinnedPointer.generation}"`;
+                    if (init?.headers?.["if-none-match"] === pinnedEtag)
+                        return respond(304);
+                    return respond(200, JSON.stringify({ generation: this.pinnedPointer.generation, releaseDigest: this.current.manifest.payload.releaseDigest, leaseSeconds: this.current.manifest.payload.leaseSeconds }), { etag: pinnedEtag });
+                }
+                const etag = `"edge-${this.edgeEtag}"`;
+                if (init?.headers?.["if-none-match"] === etag)
+                    return respond(304);
+                return respond(200, JSON.stringify({ generation: this.current.manifest.payload.generation, releaseDigest: this.current.manifest.payload.releaseDigest, leaseSeconds: this.current.manifest.payload.leaseSeconds }), { etag });
+            }
+            if (parsed.pathname.endsWith("/root.json"))
+                return respond(200, JSON.stringify(this.root));
+            if (parsed.pathname === "/s3/agent-telemetry") {
+                const reply = this.acceptUpload(init, this.now());
+                return respond(reply.status, reply.body, { "content-type": "application/xml" });
+            }
+            if (auth !== `Bearer ${this.apiKey}`)
+                return respond(401, JSON.stringify({ error: "Unauthorized" }));
+            // T23: the hosted catalogue — the manifest's tags, variables, step ids and experiment, no payloads.
+            const slotsMatch = /^\/v1\/agents\/([^/]+)\/targets\/([^/]+)\/slots$/.exec(parsed.pathname);
+            if (slotsMatch) {
+                if (slotsMatch[1] !== this.scope.agentId || slotsMatch[2] !== this.scope.target)
+                    return respond(403, JSON.stringify({ error: "Forbidden", code: "forbidden", detail: slotsMatch[1] !== this.scope.agentId ? "agent_mismatch" : "target_mismatch" }));
+                if (!this.current)
+                    return respond(404, JSON.stringify({ error: "nothing is promoted to this environment", code: "nothing_promoted" }));
+                const payload = this.current.manifest.payload;
+                return respond(200, JSON.stringify({ agentId: payload.agentId, target: payload.target, generation: payload.generation, releaseDigest: payload.releaseDigest, slots: payload.slots.map((pin) => ({ tag: pin.tag, kind: pin.kind, model: pin.model, variables: pin.variables, steps: pin.steps ? pin.steps.map((s) => ({ stepId: s.stepId })) : null })), experiment: payload.experiment ? { salt: payload.experiment.salt, subjectKey: payload.experiment.subjectKey, arms: payload.experiment.arms.map((a) => a.arm) } : null }), { "x-agent-generation": String(payload.generation) });
+            }
+            // T9: the heartbeat — the protocol schema's required keys, content-free; answers the cadence and the expiry.
+            const heartbeatMatch = /^\/v1\/agents\/([^/]+)\/targets\/([^/]+)\/heartbeat$/.exec(parsed.pathname);
+            if (heartbeatMatch) {
+                if (heartbeatMatch[1] !== this.scope.agentId || heartbeatMatch[2] !== this.scope.target)
+                    return respond(403, JSON.stringify({ error: "x", details: { code: heartbeatMatch[1] !== this.scope.agentId ? "agent_mismatch" : "target_mismatch" } }));
+                if (this.heartbeatRefusal)
+                    return respond(this.heartbeatRefusal.status, JSON.stringify({ error: "x", details: { code: this.heartbeatRefusal.code } }));
+                const body = JSON.parse(typeof init?.body === "string" ? init.body : init?.body ? Buffer.from(init.body).toString("utf8") : "{}");
+                for (const key of ["protocol", "instanceId", "sdk", "syncMode", "generation", "applyState", "storageProtection", "catalog", "lease", "spool"]) {
+                    if (!(key in body))
+                        return respond(400, JSON.stringify({ error: `heartbeat: missing ${key}` }));
+                }
+                for (const key of Object.keys(body)) {
+                    if (!["protocol", "instanceId", "instanceClass", "sdk", "host", "syncMode", "heartbeatIntervalSeconds", "generation", "activeReleaseDigest", "stagedReleaseDigest", "applyState", "refusal", "signingKeyId", "storageProtection", "catalog", "lease", "localRollback", "spool", "unlockRequestsSeen", "disabled", "applyPolicy"].includes(key))
+                        return respond(400, JSON.stringify({ error: `heartbeat: unknown ${key}` }));
+                }
+                this.heartbeats.push(body);
+                const answer = { pollSeconds: 30, uploadIntervalSeconds: this.uploadIntervalSeconds, heartbeatIntervalSeconds: this.heartbeatIntervalSeconds, expiresAt: new Date(Date.now() + this.heartbeatIntervalSeconds * 3000).toISOString() };
+                // S3: the authenticated answer names the origin's generation; a runtime whose pointer says less goes to the manifest.
+                if (this.heartbeatLatestGeneration)
+                    answer.latestGeneration = this.current?.manifest.payload.generation ?? 0;
+                if (this.grantBaseUrl) {
+                    if (this.grantHold)
+                        answer.retryAfterSeconds = this.grantHold.retryAfterSeconds;
+                    else
+                        answer.uploadGrant = this.issueGrant(String(body.instanceId), this.now());
+                }
+                return respond(200, JSON.stringify(answer), { "content-type": "application/json" });
+            }
+            const manifestMatch = /^\/v1\/agents\/([^/]+)\/targets\/([^/]+)\/manifest$/.exec(parsed.pathname);
+            if (manifestMatch) {
+                if (manifestMatch[1] !== this.scope.agentId)
+                    return respond(403, JSON.stringify({ error: "x", details: { code: "agent_mismatch" } }));
+                if (manifestMatch[2] !== this.scope.target)
+                    return respond(403, JSON.stringify({ error: "x", details: { code: "target_mismatch" } }));
+                if (!this.current)
+                    return respond(404, JSON.stringify({ error: "Not found" }));
+                if (init?.headers?.["if-none-match"] === this.current.etag)
+                    return respond(304, "", { etag: this.current.etag });
+                return respond(200, this.current.bytes, { etag: this.current.etag, "x-agent-generation": String(this.current.manifest.payload.generation), "content-type": "application/json" });
+            }
+            const payloadMatch = /^\/v1\/agents\/([^/]+)\/payloads\/(sha256:[0-9a-f]{64})$/.exec(parsed.pathname);
+            if (payloadMatch) {
+                const bytes = this.payloads.get(payloadMatch[2]);
+                return bytes ? respond(200, bytes) : respond(404, JSON.stringify({ error: "Not found" }));
+            }
+            return respond(404, JSON.stringify({ error: "Not found" }));
+        };
+    }
+}
+/** The fake behind a real HTTP listener, for daemons and CLIs that run as their own process — and `airprompter dev` (S12). */
+export async function serveOverHttp(plane, listen = {}) {
+    const { createServer } = await import("node:http");
+    const fetchImpl = plane.fetch();
+    const server = createServer((request, response) => {
+        void (async () => {
+            const headers = {};
+            for (const [name, value] of Object.entries(request.headers))
+                if (typeof value === "string")
+                    headers[name.toLowerCase()] = value;
+            const url = `http://${request.headers.host ?? "127.0.0.1"}${request.url ?? "/"}`;
+            const chunks = [];
+            for await (const chunk of request)
+                chunks.push(Buffer.from(chunk));
+            const raw = Buffer.concat(chunks);
+            const body = raw.length === 0 ? undefined : headers["content-type"]?.startsWith("multipart/") ? raw : raw.toString("utf8");
+            const result = (await fetchImpl(url, { method: request.method ?? "GET", headers, ...(body !== undefined ? { body } : {}) }));
+            const answer = Buffer.from(await result.arrayBuffer());
+            response.writeHead(result.status, Object.fromEntries(result.headerEntries ?? []));
+            response.end(answer);
+        })();
+    });
+    const host = listen.host ?? "127.0.0.1";
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(listen.port ?? 0, host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    return { baseUrl: `http://${host.includes(":") ? `[${host}]` : host}:${address.port}`, close: () => new Promise((resolve) => server.close(() => resolve())) };
+}
+//# sourceMappingURL=controlPlane.js.map

package/dist/esm/testing/controlPlane.js.map

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

package/dist/esm/testing/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The testing kit (S2, AIR-1970): what our own vectors run over and what a
+ * customer's CI can import to prove the same things about their host —
+ * a filesystem that fills, fails and loses files (`MemoryFs`), a clock
+ * that advances and skews (`FakeClock`), and the fake registry the SDK
+ * tests use (`FakeControlPlane`: signed manifests, refusals, lease and a
+ * 15-minute upload grant that expires). Nothing here is ever loaded by the
+ * runtime.
+ */
+import type { ClockPort } from "../protocol/ports.js";
+export { MemoryFs } from "./memoryFs.js";
+export { FakeControlPlane, PROTOCOL, newKey, rootDocument, serveOverHttp, type SlotSpec } from "./controlPlane.js";
+/** A clock a test moves by hand: `advance(ms)`, or `skew(ms)` to model a host whose clock is off. */
+export declare class FakeClock implements ClockPort {
+    private currentMs;
+    private offsetMs;
+    constructor(currentMs?: number);
+    nowMs(): number;
+    advance(ms: number): void;
+    set(ms: number): void;
+    /** Two hosts with the same `currentMs` and different skews disagree by the difference — the ramp walk's vector. */
+    skew(ms: number): void;
+    /** The `now` callback the facade and uploader accept. */
+    readonly now: () => number;
+}

package/dist/esm/testing/index.js

@@ -0,0 +1,35 @@
+/**
+ * The testing kit (S2, AIR-1970): what our own vectors run over and what a
+ * customer's CI can import to prove the same things about their host —
+ * a filesystem that fills, fails and loses files (`MemoryFs`), a clock
+ * that advances and skews (`FakeClock`), and the fake registry the SDK
+ * tests use (`FakeControlPlane`: signed manifests, refusals, lease and a
+ * 15-minute upload grant that expires). Nothing here is ever loaded by the
+ * runtime.
+ */
+export { MemoryFs } from "./memoryFs.js";
+export { FakeControlPlane, PROTOCOL, newKey, rootDocument, serveOverHttp } from "./controlPlane.js";
+/** A clock a test moves by hand: `advance(ms)`, or `skew(ms)` to model a host whose clock is off. */
+export class FakeClock {
+    currentMs;
+    offsetMs = 0;
+    constructor(currentMs = Date.UTC(2026, 8, 13, 12, 0, 0)) {
+        this.currentMs = currentMs;
+    }
+    nowMs() {
+        return this.currentMs + this.offsetMs;
+    }
+    advance(ms) {
+        this.currentMs += ms;
+    }
+    set(ms) {
+        this.currentMs = ms;
+    }
+    /** Two hosts with the same `currentMs` and different skews disagree by the difference — the ramp walk's vector. */
+    skew(ms) {
+        this.offsetMs = ms;
+    }
+    /** The `now` callback the facade and uploader accept. */
+    now = () => this.nowMs();
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AAEnH,qGAAqG;AACrG,MAAM,OAAO,SAAS;IAEA;IADZ,QAAQ,GAAG,CAAC,CAAC;IACrB,YAAoB,YAAoB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAAnD,cAAS,GAAT,SAAS,CAA0C;IAAG,CAAC;IAC3E,KAAK;QACH,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IACD,mHAAmH;IACnH,IAAI,CAAC,EAAU;QACb,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IACD,yDAAyD;IAChD,GAAG,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;CAC3C"}

package/dist/esm/testing/memoryFs.d.ts

@@ -0,0 +1,64 @@
+/**
+ * `MemoryFs` (S2, AIR-1970): a filesystem that fills, fails and loses files
+ * on demand — the fake our own rule requires ("a forgiving fake hides every
+ * budget bug"). Same contract as the Node port, so the spool, the store and
+ * the uploader run over it unchanged.
+ *
+ * - `capacityBytes`: writes past it throw `ENOSPC`, like a full disk.
+ * - `failNext(op, code, times?)`: the next call(s) to `op` throw that code.
+ * - `vanish(path)`: the file disappears out from under a listing (the
+ *   sibling-process race the budget sweep must survive).
+ * - `bytesUsed()` and `tree()`: what a customer's CI asserts against.
+ *
+ * Handles are numbers; a closed or unknown handle throws `EBADF`.
+ */
+import type { FsFailure, FsOpenFlags, FsPort } from "../protocol/ports.js";
+type Op = keyof FsPort;
+export declare class MemoryFs implements FsPort {
+    capacityBytes: number;
+    private readonly files;
+    private readonly dirs;
+    private readonly handles;
+    private nextFd;
+    private readonly pending;
+    /** Every operation in order — a test asserts what the spool did, not only what it left. */
+    readonly journal: Array<{
+        op: Op;
+        path: string;
+    }>;
+    clockMs: number;
+    constructor(capacityBytes?: number);
+    /** The next `times` calls to `op` fail with `code`. */
+    failNext(op: Op, code: FsFailure["code"], times?: number): void;
+    /** The file is gone without a rename or unlink — a sibling process took it. */
+    vanish(path: string): void;
+    bytesUsed(): number;
+    /** Every file path, sorted, with its size. */
+    tree(): Array<{
+        path: string;
+        bytes: number;
+    }>;
+    private gate;
+    private ensureCapacity;
+    mkdirp(path: string, _mode?: number): void;
+    exists(path: string): boolean;
+    list(dir: string): string[];
+    listRecursive(dir: string): string[];
+    stat(path: string): {
+        size: number;
+        mtimeMs: number;
+    };
+    open(path: string, flags: FsOpenFlags, mode?: number): number;
+    write(fd: number, bytes: Uint8Array): void;
+    fsync(fd: number): void;
+    close(fd: number): void;
+    rename(from: string, to: string): void;
+    unlink(path: string): void;
+    readFile(path: string): Uint8Array;
+    writeFile(path: string, bytes: Uint8Array, mode?: number): void;
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): void;
+}
+export {};