@agenthippo-ai/agenthippo 0.1.1 → 1.110.9

package/out/test/idp-init.test.js

@@ -0,0 +1,151 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  IdP Init Test Suite (PLAN/deploy.md — "customer 0")
+ *
+ *  Verifies `agenthippo idp init` generates a self-contained stack: no repo dependency in the
+ *  auth-broker image, identity routes reused verbatim from renderIdentityLayer (no drift risk),
+ *  and valid YAML/bash throughout.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+require("mocha");
+const assert = __importStar(require("assert"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const yaml = __importStar(require("js-yaml"));
+const idp_init_1 = require("../cli/idp-init");
+const idp_1 = require("../cli/commands/idp");
+suite('idp-init: renderIdpArtifacts', () => {
+    test('generates a self-contained stack — no monorepo build context', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        assert.ok(files['Dockerfile.auth-broker'].includes('FROM ghcr.io/agenthippoai/runtime'), 'auth-broker image must come from the published runtime image, not repo build artifacts');
+        assert.ok(!files['Dockerfile.auth-broker'].includes('extensions/agentide/dist'), 'must not reference this repo\'s local build output — a customer never has it');
+        assert.ok(files['docker-compose.yml'].includes('dockerfile: Dockerfile.auth-broker')
+            && files['docker-compose.yml'].includes('context: .'), 'auth-broker builds from the generated dir itself, not a monorepo path');
+    });
+    test('docker-compose.yml is valid YAML with the expected services and networks', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        const compose = yaml.load(files['docker-compose.yml']);
+        assert.deepStrictEqual(Object.keys(compose.services), ['oauth2-proxy', 'auth-broker', 'caddy', 'cloudflared']);
+        assert.ok(!('agent' in compose.services), 'the IdP runs no agent');
+        assert.deepStrictEqual(Object.keys(compose.networks), ['default', 'colocate']);
+        assert.ok(files['docker-compose.yml'].includes('name: agenthippo-idp-colocate'));
+    });
+    test('Caddyfile reuses renderIdentityLayer verbatim — self-issued, no agent backend', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        const caddy = files['Caddyfile'];
+        assert.ok(caddy.includes('import agents/*.caddy'), 'colocated agents import in');
+        assert.ok(caddy.includes('handle /oauth/authorize {') && caddy.includes('handle /oauth/browser-login {'));
+        assert.ok(caddy.includes('forward_auth oauth2-proxy:4180'), 'self-issued: gates via oauth2-proxy');
+        assert.ok(caddy.includes('reverse_proxy auth-broker:9780'), 'health checks the broker, not an agent');
+        assert.ok(caddy.includes('respond "not_found" 404'), 'no /v1/* API here — Bearer requests 404, not silently passed through');
+        assert.ok(caddy.includes('respond "AgentHippo IdP" 200'), 'browser catch-all, past the SSO gate');
+        assert.ok(caddy.includes('http://{$AGENTHIPPO_PUBLIC_HOSTNAME} {') && !caddy.includes('https://{$AGENTHIPPO_PUBLIC_HOSTNAME}'), 'plain HTTP — auto_https is off, TLS terminates in front');
+    });
+    test('.env.auth.example carries the shared JWT secret + Google OAuth client, no fed vars', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        const auth = files['.env.auth.example'];
+        assert.ok(auth.includes('AGENTHIPPO_AUTH_JWT_SECRET') && auth.includes('OAUTH2_PROXY_CLIENT_ID'));
+        assert.ok(!auth.includes('AGENTHIPPO_AUTH_IDP_URL'), 'the IdP is not itself federated against anything');
+    });
+    test('cookie domain defaults to the hostname\'s own parent domain when not given explicitly', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        assert.ok(files['.env.auth.example'].includes('AGENTHIPPO_AUTH_COOKIE_DOMAIN=.corp.example'));
+    });
+    test('explicit cookieDomain overrides the derived default', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.eu.corp.example', cookieDomain: '.corp.example' });
+        assert.ok(files['.env.auth.example'].includes('AGENTHIPPO_AUTH_COOKIE_DOMAIN=.corp.example'));
+    });
+    test('run.sh is valid bash and reflects the hostname', () => {
+        const files = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' });
+        assert.doesNotThrow(() => (0, child_process_1.execFileSync)('bash', ['-n', '-c', files['run.sh']]));
+        assert.ok(files['run.sh'].includes('auth.corp.example'));
+    });
+    // Bare metal / BYO nginx or ALB (e.g. Hetzner): run.sh must not hard-require a Cloudflare
+    // Tunnel, and Caddy's host port must be reconfigurable when 80/443 are already taken by the
+    // operator's own reverse proxy.
+    test('run.sh branches on an explicit tunnel-credentials path argument, not a fixed file location', () => {
+        const sh = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' })['run.sh'];
+        assert.ok(sh.includes('if [[ $# -ge 1 ]]; then'), 'branches on whether an argument was passed');
+        assert.ok(!sh.includes('-f "$HOME/.agent-hippo/tunnel-credentials.json"'), 'must not infer tunnel mode from a fixed default file path');
+        assert.ok(sh.includes('AGENTHIPPO_TUNNEL_CREDENTIALS="$1"'), 'the argument becomes the credentials path');
+        assert.ok(sh.includes('docker compose --profile edge --profile tunnel up -d --build'));
+        assert.ok(sh.includes('docker compose --profile edge up -d --build'), 'no-argument branch: --profile edge only, no --profile tunnel');
+    });
+    test('run.sh fails loudly if a given tunnel-credentials path doesn\'t exist', () => {
+        const sh = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' })['run.sh'];
+        assert.ok(sh.includes('[[ -f "$AGENTHIPPO_TUNNEL_CREDENTIALS" ]] || {'));
+        assert.ok(sh.includes('exit 1'));
+    });
+    test('docker-compose.yml wires the cloudflared credentials mount to AGENTHIPPO_TUNNEL_CREDENTIALS', () => {
+        const compose = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' })['docker-compose.yml'];
+        assert.ok(compose.includes('${AGENTHIPPO_TUNNEL_CREDENTIALS:-${HOME}/.agent-hippo/tunnel-credentials.json}'));
+    });
+    test('Caddy host ports are configurable via AGENTHIPPO_CADDY_HTTP_PORT/_HTTPS_PORT (Hetzner: 80/443 may already be taken)', () => {
+        const compose = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' })['docker-compose.yml'];
+        assert.ok(compose.includes('${AGENTHIPPO_CADDY_HTTP_PORT:-80}:80'));
+        assert.ok(compose.includes('${AGENTHIPPO_CADDY_HTTPS_PORT:-443}:443'));
+    });
+    test('README documents both the Cloudflare Tunnel path and the bare-metal/BYO-nginx path', () => {
+        const readme = (0, idp_init_1.renderIdpArtifacts)({ hostname: 'auth.corp.example' })['README.md'];
+        assert.ok(readme.includes('Cloudflare Tunnel'));
+        assert.ok(readme.includes('Bare metal') || readme.includes('BYO nginx'));
+    });
+});
+suite('idp-init: idpCommand writes files to disk', () => {
+    let outDir;
+    setup(() => {
+        outDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ah-idp-'));
+    });
+    teardown(() => {
+        fs.rmSync(outDir, { recursive: true, force: true });
+    });
+    test('writes every generated file under --out', async () => {
+        await (0, idp_1.idpCommand)('init', { hostname: 'auth.corp.example', out: outDir });
+        for (const rel of ['docker-compose.yml', 'Dockerfile.auth-broker', 'Caddyfile', '.env.example', '.env.auth.example', 'run.sh', 'agents/README.md', 'README.md']) {
+            assert.ok(fs.existsSync(path.join(outDir, rel)), `${rel} should be written`);
+        }
+    });
+    test('refuses to overwrite existing files without --force', async () => {
+        await (0, idp_1.idpCommand)('init', { hostname: 'auth.corp.example', out: outDir });
+        fs.writeFileSync(path.join(outDir, 'README.md'), 'hand-edited\n');
+        await (0, idp_1.idpCommand)('init', { hostname: 'auth.corp.example', out: outDir });
+        assert.strictEqual(fs.readFileSync(path.join(outDir, 'README.md'), 'utf8'), 'hand-edited\n');
+        await (0, idp_1.idpCommand)('init', { hostname: 'auth.corp.example', out: outDir, force: true });
+        assert.notStrictEqual(fs.readFileSync(path.join(outDir, 'README.md'), 'utf8'), 'hand-edited\n');
+    });
+});

package/out/test/lease-signature.test.js

@@ -0,0 +1,357 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Signed leases, lease validation, and the staleness ceiling.
+ *
+ *  The whole governance story — kill switch, deny rules, caps, version pin, pack signing — was
+ *  rooted in an UNSIGNED document fetched over an unauthenticated channel and `JSON.parse`d
+ *  straight into policy. Anyone who could answer AGENTHIPPO_LEASE_URL could lift the kill switch;
+ *  anyone who could drop packets to it could keep a revoked fleet running indefinitely.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+require("mocha");
+const assert = __importStar(require("assert"));
+const warrant_1 = require("../authority/warrant");
+const lease_1 = require("../pack/lease");
+const key = (0, warrant_1.generateWarrantKeypair)('lease-k1');
+const keys = { 'lease-k1': key.publicKeyPem };
+const NOW = 1_800_000_000;
+const lease = { pack: 'analyst', expiresAt: NOW + 3600, enabled: true };
+const bodyResponse = (text) => ({
+    ok: true,
+    status: 200,
+    text: async () => text,
+    json: async () => JSON.parse(text),
+});
+const collectLogs = () => {
+    const lines = [];
+    return { lines, logger: { info: (m) => lines.push(m), warn: (m) => lines.push(m) } };
+};
+suite('signed lease — envelope verification', () => {
+    test('a lease signed by a trusted key verifies, and the policy survives intact', () => {
+        const token = (0, lease_1.signLease)(lease, key, { instanceId: 'inst-1', nowSeconds: NOW });
+        const res = (0, lease_1.verifySignedLease)(token, keys, { instanceId: 'inst-1', nowSeconds: NOW });
+        assert.ok(res.ok, res.ok ? '' : res.reason);
+        assert.deepStrictEqual(res.lease, lease);
+    });
+    test('an empty keyring never verifies — the same rule packs get', () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        const res = (0, lease_1.verifySignedLease)(token, {}, { nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+    });
+    test('a key we do not trust is refused, never trusted-on-first-use', () => {
+        const stranger = (0, warrant_1.generateWarrantKeypair)('evil');
+        const token = (0, lease_1.signLease)({ ...lease, enabled: true }, stranger, { nowSeconds: NOW });
+        const res = (0, lease_1.verifySignedLease)(token, keys, { nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /unknown kid/);
+    });
+    test('a tampered payload breaks the signature', () => {
+        const token = (0, lease_1.signLease)({ ...lease, enabled: false }, key, { nowSeconds: NOW });
+        const [h, , s] = token.split('.');
+        const forged = Buffer.from(JSON.stringify({
+            lease: { ...lease, enabled: true }, aud: '*', sub: 'analyst', iat: NOW, exp: NOW + 300,
+        })).toString('base64url');
+        const res = (0, lease_1.verifySignedLease)(`${h}.${forged}.${s}`, keys, { nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /bad signature/);
+    });
+    test('a lease for another instance does not verify here (audience binding)', () => {
+        const token = (0, lease_1.signLease)(lease, key, { instanceId: 'inst-other', nowSeconds: NOW });
+        const res = (0, lease_1.verifySignedLease)(token, keys, { instanceId: 'inst-1', nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /for instance inst-other/);
+    });
+    test('a fleet-wide (*) lease is accepted by any instance', () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        assert.ok((0, lease_1.verifySignedLease)(token, keys, { instanceId: 'inst-1', nowSeconds: NOW }).ok);
+    });
+    test('an expired envelope is refused even though the LEASE has not expired', () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW, ttlSeconds: 60 });
+        const res = (0, lease_1.verifySignedLease)(token, keys, { nowSeconds: NOW + 3600 });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /envelope expired/);
+    });
+    test('envelope TTL is capped — a lease refresh must not become a credential', () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW, ttlSeconds: 99_999 });
+        // The cap is applied at signing; verification also refuses anything longer.
+        const res = (0, lease_1.verifySignedLease)(token, keys, { nowSeconds: NOW + lease_1.MAX_LEASE_ENVELOPE_TTL_SECONDS - 1 });
+        assert.ok(res.ok, 'inside the capped lifetime it is still valid');
+        assert.strictEqual((0, lease_1.verifySignedLease)(token, keys, { nowSeconds: NOW + lease_1.MAX_LEASE_ENVELOPE_TTL_SECONDS + 120 }).ok, false);
+    });
+    /**
+     * The binding that matters most. `governor.checkLease` treats a restored lease as "lease
+     * restored — accepting turns again", so replaying an older `enabled: true` envelope does not
+     * merely delay a kill: it LIFTS one that has already latched.
+     */
+    test('an older envelope is refused as a rollback replay', () => {
+        const older = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        const newer = (0, lease_1.signLease)({ ...lease, enabled: false }, key, { nowSeconds: NOW + 100 });
+        assert.ok((0, lease_1.verifySignedLease)(newer, keys, { nowSeconds: NOW + 100 }).ok);
+        const replay = (0, lease_1.verifySignedLease)(older, keys, { nowSeconds: NOW + 120, minIat: NOW + 100 });
+        assert.strictEqual(replay.ok, false);
+        assert.match(replay.reason, /replay\/rollback/);
+    });
+    test('a pack signature cannot be replayed as a lease under the same key (typ binding)', () => {
+        // A JWT-typed token signed by the same key must not pass as a lease envelope.
+        const notALease = require('../authority/warrant').signCompactJws({ typ: 'JWT', kid: 'lease-k1' }, { lease, aud: '*', sub: 'analyst', iat: NOW, exp: NOW + 300 }, key.privateKeyPem);
+        const res = (0, lease_1.verifySignedLease)(notALease, keys, { nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /unexpected token type/);
+    });
+    test('a signed lease carrying a malformed policy is refused, not half-adopted', () => {
+        const token = (0, lease_1.signLease)({ ...lease, caps: { maxTurnsPerSession: 'lots' } }, key, { nowSeconds: NOW });
+        const res = (0, lease_1.verifySignedLease)(token, keys, { nowSeconds: NOW });
+        assert.strictEqual(res.ok, false);
+        assert.match(res.reason, /malformed/);
+    });
+});
+suite('requireSignedLease is tighten-only', () => {
+    test('either side may demand it; neither may waive the other', () => {
+        assert.strictEqual((0, lease_1.requireSignedLease)(undefined, undefined), false);
+        assert.strictEqual((0, lease_1.requireSignedLease)(true, undefined), true);
+        assert.strictEqual((0, lease_1.requireSignedLease)(undefined, true), true);
+        assert.strictEqual((0, lease_1.requireSignedLease)(false, true), true);
+    });
+});
+suite('lease source — signature enforcement', () => {
+    test('a signed lease is accepted and reported as signed', async () => {
+        const token = (0, lease_1.signLease)(lease, key, { instanceId: 'inst-1', nowSeconds: NOW });
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            instanceId: 'inst-1',
+            signingKeys: () => keys,
+            fetchImpl: (async () => bodyResponse(JSON.stringify({ lease: token }))),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+        assert.strictEqual(src.status(NOW).signed, true);
+    });
+    test('a bare compact-JWS body works too', async () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            signingKeys: () => keys,
+            fetchImpl: (async () => bodyResponse(token)),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+    });
+    test('an unsigned lease still works, and says so LOUDLY, when signing is not required', async () => {
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            logger,
+            fetchImpl: (async () => bodyResponse(JSON.stringify(lease))),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+        assert.ok(lines.some((l) => /UNSIGNED lease/.test(l)), 'back-compat must not be silent');
+    });
+    test('an unsigned lease is REFUSED when signing is required — and the last good lease stands', async () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        let signed = true;
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            requireSignedLease: true,
+            signingKeys: () => keys,
+            fetchImpl: (async () => bodyResponse(signed ? token : JSON.stringify({ ...lease, enabled: true }))),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+        signed = false;
+        // A downgrade to unsigned must not install new policy.
+        const after = await src.get(NOW + 1);
+        assert.deepStrictEqual(after, lease, 'the verified lease is kept; the unsigned one is rejected');
+    });
+    test('lease.requireSignedLease LATCHES — a later unsigned response cannot undo it', async () => {
+        const demanding = (0, lease_1.signLease)({ ...lease, requireSignedLease: true }, key, { nowSeconds: NOW });
+        let phase = 'signed';
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            logger,
+            signingKeys: () => keys,
+            fetchImpl: (async () => bodyResponse(phase === 'signed' ? demanding : JSON.stringify({ ...lease, enabled: true, version: '9.9.9' }))),
+        });
+        const first = await src.get(NOW);
+        assert.strictEqual(first?.requireSignedLease, true);
+        phase = 'unsigned';
+        const second = await src.get(NOW + 1);
+        assert.strictEqual(second?.version, undefined, 'the unsigned downgrade must not take effect');
+        assert.ok(lines.some((l) => /signed lease is required/.test(l)));
+    });
+});
+/**
+ * The insecure-channel warning, which for one shape did not exist.
+ *
+ * `createLeaseSource` carried a `leaseUrlRefused` flag, declared and read but never assigned — its
+ * comment promised "we never poll it at all", a refusal the file elsewhere argues explicitly
+ * against (refusing to poll a plaintext lease URL disables the kill switch, which fails OPEN).
+ * Worse, the warning next to it was guarded by `else if (!signingRequired())`, so the one operator
+ * who most needed to hear it — one who has demanded signed leases and therefore believes the
+ * channel is accounted for — was the only one who heard nothing at all.
+ */
+suite('lease source — a plaintext lease URL warns, always, and never stops the poll', () => {
+    // An explicit empty env: the ambient ALLOW_INSECURE_TRUST_ROOT escape hatch must not decide
+    // what these tests observe.
+    const noEnv = {};
+    test('http + signing NOT required — warns, and keeps polling', async () => {
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'http://plane.example/lease',
+            cacheSeconds: 0,
+            env: noEnv,
+            logger,
+            fetchImpl: (async () => bodyResponse(JSON.stringify(lease))),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease, 'refusing to poll would disable the kill switch');
+        assert.ok(lines.some((l) => /INSECURE LEASE CHANNEL/.test(l)));
+    });
+    test('http + signing REQUIRED — still warns; this was the silent case', async () => {
+        const token = (0, lease_1.signLease)(lease, key, { nowSeconds: NOW });
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'http://plane.example/lease',
+            cacheSeconds: 0,
+            env: noEnv,
+            logger,
+            requireSignedLease: true,
+            signingKeys: () => keys,
+            fetchImpl: (async () => bodyResponse(token)),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease, 'a signed lease over http is still polled');
+        const warning = lines.find((l) => /INSECURE LEASE CHANNEL/.test(l));
+        assert.ok(warning, 'signing-required over plaintext must not be the quiet case');
+        // And it must say what signing does NOT buy, rather than repeating "set requireSignedLease"
+        // at an operator who already did.
+        assert.match(warning, /not a substitute for https/i);
+    });
+    test('https warns about nothing', async () => {
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            env: noEnv,
+            logger,
+            fetchImpl: (async () => bodyResponse(JSON.stringify(lease))),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+        assert.ok(!lines.some((l) => /INSECURE LEASE CHANNEL/.test(l)));
+    });
+});
+suite('lease source — a garbled document is not policy', () => {
+    const badBodies = [
+        ['non-numeric cap', JSON.stringify({ ...lease, caps: { maxTurnsPerSession: 'lots' } })],
+        ['negative cap', JSON.stringify({ ...lease, caps: { maxSessionSeconds: -5 } })],
+        ['string enabled', JSON.stringify({ ...lease, enabled: 'false' })],
+        ['unknown deny scope', JSON.stringify({ ...lease, deny: [{ scope: 'tenant', match: 'x', mode: 'kill' }] })],
+        ['not an object', '"hello"'],
+        ['not JSON at all', '<html>502</html>'],
+    ];
+    for (const [name, body] of badBodies) {
+        test(`${name} is rejected and the previous lease is kept`, async () => {
+            let good = true;
+            const { lines, logger } = collectLogs();
+            const src = (0, lease_1.createLeaseSource)({
+                url: 'https://plane.example/lease',
+                cacheSeconds: 0,
+                logger,
+                fetchImpl: (async () => bodyResponse(good ? JSON.stringify(lease) : body)),
+            });
+            assert.deepStrictEqual(await src.get(NOW), lease);
+            good = false;
+            assert.deepStrictEqual(await src.get(NOW + 1), lease, 'junk must never replace a validated lease');
+            assert.ok(lines.some((l) => /fetch failed/.test(l)), 'and the rejection must be logged');
+        });
+    }
+    test('a NaN cap cannot reach the meter — where every comparison would be false', async () => {
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            fetchImpl: (async () => bodyResponse(JSON.stringify({ ...lease, caps: { maxTurnsPerSession: null } }))),
+        });
+        const got = await src.get(NOW);
+        assert.strictEqual(got?.caps?.maxTurnsPerSession, undefined, 'null is dropped, never carried through as a cap');
+    });
+});
+suite('lease source — staleness ceiling (kill switch under network denial)', () => {
+    test('past the ceiling, the instance fails CLOSED with an actionable reason', async () => {
+        let alive = true;
+        const { lines, logger } = collectLogs();
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            maxStalenessSeconds: 100,
+            logger,
+            fetchImpl: (async () => {
+                if (!alive) {
+                    throw new Error('control plane unreachable');
+                }
+                return bodyResponse(JSON.stringify(lease));
+            }),
+        });
+        assert.deepStrictEqual(await src.get(NOW), lease);
+        alive = false;
+        assert.strictEqual((await src.get(NOW + 50))?.enabled, true, 'inside the ceiling we still fail OPEN on transport');
+        const stale = await src.get(NOW + 200);
+        assert.strictEqual(stale?.enabled, false, 'past the ceiling the kill switch can no longer be starved out');
+        assert.match(stale?.reason ?? '', /staleness ceiling/);
+        assert.ok(lines.some((l) => /STALENESS CEILING PASSED/.test(l)));
+        assert.strictEqual(src.status(NOW + 200).failClosed, true);
+    });
+    test('0 disables the ceiling — an operator can explicitly accept unbounded staleness', async () => {
+        let alive = true;
+        const src = (0, lease_1.createLeaseSource)({
+            url: 'https://plane.example/lease',
+            cacheSeconds: 0,
+            maxStalenessSeconds: 0,
+            fetchImpl: (async () => {
+                if (!alive) {
+                    throw new Error('down');
+                }
+                return bodyResponse(JSON.stringify(lease));
+            }),
+        });
+        await src.get(NOW);
+        alive = false;
+        assert.strictEqual((await src.get(NOW + 10_000_000))?.enabled, true);
+    });
+    test('an unmanaged deployment (no lease URL) is untouched by any of this', async () => {
+        const src = (0, lease_1.createLeaseSource)({ maxStalenessSeconds: 1 });
+        assert.strictEqual(await src.get(NOW + 1_000_000), undefined);
+    });
+});