@astrasyncai/verification-gateway 5.9.0 → 5.11.0

package/dist/codex/index.d.mts

@@ -1,4 +1,5 @@
 import { f as PlatformAdapter, A as AdapterConfig, a as AgentAction, I as InterceptResult, P as PDLSSContext, V as VerificationDecision, b as AstraSyncGateway } from '../interface-q1WrMsB1.mjs';
+import { F as FleetPaths } from '../enrolment-store-8DyaIOLe.mjs';
 
 /**
  * @astrasyncai/adapter-codex
@@ -173,6 +174,10 @@ interface ProcessCodexHookOptions {
     home?: string;
     /** Injectable for tests */
     gatewayFactory?: (config: ConstructorParameters<typeof AstraSyncGateway>[0]) => AstraSyncGateway;
+    /** Injectable for tests: fleet enrolment/cache locations. */
+    fleetPaths?: FleetPaths;
+    /** Injectable for tests: clock for the fleet heartbeat throttle. */
+    now?: () => number;
 }
 interface ProcessCodexHookResult {
     output: CodexHookOutput | null;

package/dist/codex/index.d.ts

@@ -1,4 +1,5 @@
 import { f as PlatformAdapter, A as AdapterConfig, a as AgentAction, I as InterceptResult, P as PDLSSContext, V as VerificationDecision, b as AstraSyncGateway } from '../interface-q1WrMsB1.js';
+import { F as FleetPaths } from '../enrolment-store-8DyaIOLe.js';
 
 /**
  * @astrasyncai/adapter-codex
@@ -173,6 +174,10 @@ interface ProcessCodexHookOptions {
     home?: string;
     /** Injectable for tests */
     gatewayFactory?: (config: ConstructorParameters<typeof AstraSyncGateway>[0]) => AstraSyncGateway;
+    /** Injectable for tests: fleet enrolment/cache locations. */
+    fleetPaths?: FleetPaths;
+    /** Injectable for tests: clock for the fleet heartbeat throttle. */
+    now?: () => number;
 }
 interface ProcessCodexHookResult {
     output: CodexHookOutput | null;

package/dist/codex/index.js

@@ -309,7 +309,8 @@ var CodexAdapter = class {
 };
 
 // src/codex/hook.ts
-var import_path4 = require("path");
+var import_os3 = require("os");
+var import_path6 = require("path");
 
 // src/gateway/types.ts
 var HIGH_RISK_COMMANDS = [
@@ -4035,7 +4036,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.9.0";
+var SDK_VERSION = "5.11.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -4354,6 +4355,24 @@ async function callVerifyAccessAPI(config, request) {
         }
       };
     }
+    if (response.status === 400 && data?.error === "INVALID_AGENT_ID") {
+      const message = typeof data?.message === "string" ? data.message : "Agent identifier must be a canonical ASTRA-* id.";
+      return {
+        success: true,
+        attemptId: typeof data?.attemptId === "string" ? data.attemptId : void 0,
+        access: {
+          allowed: false,
+          reason: "invalid_agent_id",
+          failures: [
+            {
+              dimension: "identity.invalid_agent_id",
+              message,
+              guidance: typeof data?.guidance === "string" ? data.guidance : "Present your canonical ASTRA-* id (discover it via GET /api/agents/request-registration/{requestId} after owner approval)."
+            }
+          ]
+        }
+      };
+    }
     if (!response.ok) {
       if (response.status === 401) {
         return {
@@ -5182,22 +5201,118 @@ var AstraSyncGateway = class {
 };
 
 // src/claude-code/guard-config.ts
+var import_fs5 = require("fs");
+var import_os2 = require("os");
+var import_path4 = require("path");
+
+// src/fleet/enrolment-store.ts
 var import_fs4 = require("fs");
 var import_os = require("os");
 var import_path3 = require("path");
-function resolveGuardConfig(env, payloadCwd, home = (0, import_os.homedir)()) {
+function machineScopeDir(platform = process.platform, env = process.env) {
+  if (platform === "darwin") return "/Library/Application Support/AstraSync";
+  if (platform === "win32") return (0, import_path3.join)(env.ProgramData || "C:\\ProgramData", "AstraSync");
+  return "/etc/astrasync";
+}
+function fleetPaths(options = {}) {
+  const home = options.home ?? (0, import_os.homedir)();
+  const machineDir = options.machineDir ?? options.env?.ASTRASYNC_FLEET_MACHINE_DIR ?? machineScopeDir(options.platform, options.env);
+  const userDir = (0, import_path3.join)(home, ".astrasync", "fleet");
+  return {
+    machineDevice: (0, import_path3.join)(machineDir, "fleet.json"),
+    machinePolicy: (0, import_path3.join)(machineDir, "policy.jws"),
+    userDir,
+    userDevice: (0, import_path3.join)(userDir, "device.json"),
+    userPolicy: (0, import_path3.join)(userDir, "policy.jws"),
+    userKeyChain: (0, import_path3.join)(userDir, "keychain.json"),
+    state: (0, import_path3.join)(userDir, "state.json")
+  };
+}
+function isEnrolment(value) {
+  const v = value;
+  return !!v && typeof v.deviceId === "string" && typeof v.credential === "string" && typeof v.apiBaseUrl === "string" && !!v.org && typeof v.org.ownerId === "string" && !!v.jwks && Array.isArray(v.jwks.keys);
+}
+function loadEnrolment(paths) {
+  const candidates = [
+    [paths.machineDevice, "machine"],
+    [paths.userDevice, "user"]
+  ];
+  for (const [path, scope] of candidates) {
+    if (!(0, import_fs4.existsSync)(path)) continue;
+    try {
+      const parsed = JSON.parse((0, import_fs4.readFileSync)(path, "utf-8"));
+      if (isEnrolment(parsed)) return { enrolment: parsed, scope };
+    } catch {
+    }
+    return { corrupt: true, path };
+  }
+  return null;
+}
+function writeFileMode(path, content, mode) {
+  (0, import_fs4.mkdirSync)((0, import_path3.dirname)(path), { recursive: true, mode: 448 });
+  (0, import_fs4.writeFileSync)(path, content, { encoding: "utf-8", mode });
+  try {
+    (0, import_fs4.chmodSync)(path, mode);
+  } catch {
+  }
+}
+function readCachedPolicies(paths) {
+  const out = [];
+  for (const p of [paths.userPolicy, paths.machinePolicy]) {
+    try {
+      if ((0, import_fs4.existsSync)(p)) out.push((0, import_fs4.readFileSync)(p, "utf-8").trim());
+    } catch {
+    }
+  }
+  return out.filter(Boolean);
+}
+function writeCachedPolicy(paths, jws) {
+  writeFileMode(paths.userPolicy, jws, 384);
+}
+function readKeyChain(paths) {
+  try {
+    const parsed = JSON.parse((0, import_fs4.readFileSync)(paths.userKeyChain, "utf-8"));
+    return Array.isArray(parsed) ? parsed.filter((j) => typeof j === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function writeKeyChain(paths, chain) {
+  writeFileMode(paths.userKeyChain, JSON.stringify(chain), 384);
+}
+function readState(paths) {
+  try {
+    const parsed = JSON.parse((0, import_fs4.readFileSync)(paths.state, "utf-8"));
+    const c = parsed.counts;
+    return {
+      ...parsed,
+      counts: { allow: c?.allow ?? 0, deny: c?.deny ?? 0, ask: c?.ask ?? 0 }
+    };
+  } catch {
+    return { counts: { allow: 0, deny: 0, ask: 0 } };
+  }
+}
+function writeState(paths, state) {
+  try {
+    writeFileMode(paths.state, JSON.stringify(state, null, 2), 384);
+  } catch {
+  }
+}
+
+// src/claude-code/guard-config.ts
+function resolveGuardConfig(env, payloadCwd, home = (0, import_os2.homedir)()) {
   const candidateRoots = [env.CLAUDE_PROJECT_DIR, payloadCwd, home].filter(
     (root) => typeof root === "string" && root.length > 0
   );
   for (const root of candidateRoots) {
-    const guardDir = (0, import_path3.join)(root, ".astrasync");
-    const policyFile = (0, import_path3.join)(guardDir, "policy.yaml");
-    if (!(0, import_fs4.existsSync)(policyFile)) continue;
+    const guardDir = (0, import_path4.join)(root, ".astrasync");
+    const policyFile = (0, import_path4.join)(guardDir, "policy.yaml");
+    if (!(0, import_fs5.existsSync)(policyFile)) continue;
     let settings = {};
-    const settingsFile = (0, import_path3.join)(guardDir, "guard.json");
-    if ((0, import_fs4.existsSync)(settingsFile)) {
+    const settingsFile = (0, import_path4.join)(guardDir, "guard.json");
+    if ((0, import_fs5.existsSync)(settingsFile)) {
       try {
-        settings = JSON.parse((0, import_fs4.readFileSync)(settingsFile, "utf-8"));
+        settings = JSON.parse((0, import_fs5.readFileSync)(settingsFile, "utf-8"));
       } catch {
         settings = {};
       }
@@ -5206,6 +5321,408 @@ function resolveGuardConfig(env, payloadCwd, home = (0, import_os.homedir)()) {
   }
   return null;
 }
+var FLEET_ENROL_INSTRUCTION = "This machine must be enrolled: run `astrasync guard enroll <token>` (token from your organisation admin)";
+function resolveFleet(env, home = (0, import_os2.homedir)(), paths = fleetPaths({ home, env })) {
+  const loaded = loadEnrolment(paths);
+  if (loaded && "corrupt" in loaded) {
+    return {
+      kind: "fleet-missing",
+      reason: `fleet enrolment at ${loaded.path} is unreadable \u2014 ${FLEET_ENROL_INSTRUCTION}`,
+      paths
+    };
+  }
+  if (loaded) return { kind: "fleet", enrolment: loaded.enrolment, scope: loaded.scope, paths };
+  if (env.ASTRASYNC_FLEET_REQUIRED === "1") {
+    return { kind: "fleet-missing", reason: FLEET_ENROL_INSTRUCTION, paths };
+  }
+  return null;
+}
+
+// src/fleet/hook-runner.ts
+var import_path5 = require("path");
+
+// src/fleet/client.ts
+var FleetApiError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "FleetApiError";
+  }
+};
+function base(url) {
+  return url.replace(/\/+$/, "");
+}
+async function call(url, init, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await sdkFetch(url, { ...init, signal: controller.signal });
+    const text = await res.text();
+    let body = text;
+    try {
+      body = text ? JSON.parse(text) : null;
+    } catch {
+    }
+    return { status: res.status, body, headers: res.headers };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function apiError(status, body, what) {
+  const b = body ?? {};
+  const code = b.code ?? (typeof b.error === "string" ? b.error : void 0);
+  return new FleetApiError(`${what} failed (${status}${code ? ` ${code}` : ""})`, status, code);
+}
+function deviceHeaders(enrolment) {
+  return { Authorization: `Device ${enrolment.credential}` };
+}
+function policyEtag(sha256, kid) {
+  return `${sha256}.${kid ?? ""}`;
+}
+async function fetchFleetPolicy(enrolment, ifNoneMatch, timeoutMs = 1500) {
+  const headers = deviceHeaders(enrolment);
+  if (ifNoneMatch) headers["If-None-Match"] = `"${ifNoneMatch}"`;
+  const r = await call(`${base(enrolment.apiBaseUrl)}/fleet/policy`, { headers }, timeoutMs);
+  if (r.status === 304) return { status: "unchanged" };
+  if (r.status !== 200) throw apiError(r.status, r.body, "Policy fetch");
+  const data = r.body;
+  if (!data?.policyJws) throw new FleetApiError("Policy response has no policyJws", r.status);
+  return {
+    status: "ok",
+    policyJws: data.policyJws,
+    sha256: data.sha256 ?? "",
+    version: data.version ?? 0,
+    keyChain: Array.isArray(data.keyChain) ? data.keyChain.filter((j) => typeof j === "string") : []
+  };
+}
+async function sendHeartbeat(enrolment, request, timeoutMs = 1500) {
+  const r = await call(
+    `${base(enrolment.apiBaseUrl)}/fleet/heartbeat`,
+    {
+      method: "POST",
+      headers: { ...deviceHeaders(enrolment), "Content-Type": "application/json" },
+      body: JSON.stringify(request)
+    },
+    timeoutMs
+  );
+  if (r.status !== 200) throw apiError(r.status, r.body, "Heartbeat");
+  return r.body;
+}
+
+// src/fleet/policy-verify.ts
+var import_crypto = require("crypto");
+var import_jose2 = require("jose");
+
+// src/fleet/types.ts
+var FLEET_POLICY_TYP = "fleet-policy+jwt";
+var FLEET_POLICY_AUD = "astrasync:fleet-policy";
+var FLEET_POLICY_ISS = "astrasync.ai";
+var FLEET_KEYS_TYP = "fleet-keys+jwt";
+var FLEET_KEYS_AUD = "astrasync:fleet-keys";
+var DEFAULT_HEARTBEAT_INTERVAL_SEC = 900;
+
+// src/fleet/policy-verify.ts
+var FleetPolicyError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FleetPolicyError";
+  }
+};
+function sha256Hex(text) {
+  return (0, import_crypto.createHash)("sha256").update(text, "utf8").digest("hex");
+}
+function parseSettings(raw) {
+  if (!raw || typeof raw !== "object") throw new FleetPolicyError("settings missing");
+  const s = raw;
+  if (s.posture !== "active" && s.posture !== "passive") {
+    throw new FleetPolicyError("settings.posture must be active or passive");
+  }
+  if (s.failOpen !== void 0 && typeof s.failOpen !== "boolean") {
+    throw new FleetPolicyError("settings.failOpen must be a boolean");
+  }
+  if (s.governMcp !== void 0 && typeof s.governMcp !== "boolean") {
+    throw new FleetPolicyError("settings.governMcp must be a boolean");
+  }
+  if (s.skipTools !== void 0 && !(Array.isArray(s.skipTools) && s.skipTools.every((t) => typeof t === "string"))) {
+    throw new FleetPolicyError("settings.skipTools must be a string array");
+  }
+  const num = (v) => typeof v === "number" && Number.isFinite(v) && v > 0 ? v : void 0;
+  return {
+    posture: s.posture,
+    failOpen: s.failOpen === true,
+    ...typeof s.governMcp === "boolean" && { governMcp: s.governMcp },
+    ...Array.isArray(s.skipTools) && { skipTools: s.skipTools },
+    ...num(s.heartbeatIntervalSec) && { heartbeatIntervalSec: num(s.heartbeatIntervalSec) },
+    ...num(s.staleAfterSec) && { staleAfterSec: num(s.staleAfterSec) }
+  };
+}
+async function verifyFleetPolicy(jws, jwks, options) {
+  let payloadBytes;
+  let header;
+  try {
+    const keySet = (0, import_jose2.createLocalJWKSet)(jwks);
+    const result = await (0, import_jose2.compactVerify)(jws, keySet, { algorithms: ["ES256"] });
+    payloadBytes = result.payload;
+    header = result.protectedHeader;
+  } catch (err) {
+    throw new FleetPolicyError(
+      `signature verification failed (${err instanceof Error ? err.message : String(err)})`
+    );
+  }
+  if (header.typ !== FLEET_POLICY_TYP) throw new FleetPolicyError(`unexpected typ ${header.typ}`);
+  let claims;
+  try {
+    claims = JSON.parse(new TextDecoder().decode(payloadBytes));
+  } catch {
+    throw new FleetPolicyError("payload is not JSON");
+  }
+  if (claims.aud !== FLEET_POLICY_AUD) throw new FleetPolicyError(`unexpected aud ${claims.aud}`);
+  if (claims.iss !== FLEET_POLICY_ISS) throw new FleetPolicyError(`unexpected iss ${claims.iss}`);
+  if (!options.expectedSubs.includes(claims.sub)) {
+    throw new FleetPolicyError("policy was issued for a different organisation or device");
+  }
+  if (!Number.isInteger(claims.ver) || claims.ver < 1) {
+    throw new FleetPolicyError("ver must be a positive integer");
+  }
+  if (options.minVer !== void 0 && claims.ver < options.minVer) {
+    throw new FleetPolicyError(
+      `policy version ${claims.ver} is older than the accepted version ${options.minVer} (rollback)`
+    );
+  }
+  if (typeof claims.yaml !== "string" || sha256Hex(claims.yaml) !== claims.sha256) {
+    throw new FleetPolicyError("policy hash mismatch");
+  }
+  const settings = parseSettings(claims.settings);
+  const parsed = parseYaml(claims.yaml);
+  if (!parsed.policy) {
+    const first = parsed.validation.errors[0];
+    throw new FleetPolicyError(
+      `signed policy is invalid${first ? ` (${first.path}: ${first.message})` : ""}`
+    );
+  }
+  return { kid: header.kid, claims: { ...claims, settings }, policy: parsed.policy, settings, jws };
+}
+async function resolveFleetJwks(pinned, chain, ownerId) {
+  let trusted = pinned;
+  let lastSeq = 0;
+  for (const link of chain) {
+    try {
+      const { payload, protectedHeader } = await (0, import_jose2.compactVerify)(
+        link,
+        (0, import_jose2.createLocalJWKSet)(trusted),
+        { algorithms: ["ES256"] }
+      );
+      if (protectedHeader.typ !== FLEET_KEYS_TYP) continue;
+      const c = JSON.parse(new TextDecoder().decode(payload));
+      if (c.aud !== FLEET_KEYS_AUD || c.iss !== FLEET_POLICY_ISS || c.sub !== ownerId) continue;
+      if (!Number.isInteger(c.seq) || c.seq <= lastSeq) continue;
+      const keys = Array.isArray(c.keys) ? c.keys.filter((k) => k && k.kty === "EC" && k.crv === "P-256" && !("d" in k)) : [];
+      if (keys.length === 0) continue;
+      trusted = { keys };
+      lastSeq = c.seq;
+    } catch {
+    }
+  }
+  return trusted;
+}
+async function pickNewestValid(candidates, jwks, options) {
+  let best = null;
+  let lastError = new FleetPolicyError("no cached fleet policy");
+  for (const jws of candidates) {
+    try {
+      const v = await verifyFleetPolicy(jws, jwks, options);
+      if (!best || v.claims.ver > best.claims.ver) best = v;
+    } catch (err) {
+      lastError = err instanceof Error ? err : new FleetPolicyError(String(err));
+    }
+  }
+  if (!best) throw lastError;
+  return best;
+}
+
+// src/fleet/runtime.ts
+var FLEET_SYNC_BUDGET_MS = 1500;
+function expectedSubs(enrolment) {
+  return [enrolment.org.ownerId, enrolment.deviceId];
+}
+function fleetJwks(ctx, chain = readKeyChain(ctx.paths)) {
+  return resolveFleetJwks(ctx.enrolment.jwks, chain, ctx.enrolment.org.ownerId);
+}
+async function acceptFetched(ctx, fetched, verifyOpts) {
+  const jwks = await fleetJwks(ctx, fetched.keyChain);
+  const verified = await verifyFleetPolicy(fetched.policyJws, jwks, verifyOpts);
+  if (fetched.keyChain.length > 0) writeKeyChain(ctx.paths, fetched.keyChain);
+  writeCachedPolicy(ctx.paths, fetched.policyJws);
+  return verified;
+}
+function remember(paths, state, verified) {
+  state.appliedSha256 = verified.claims.sha256;
+  state.maxVer = Math.max(state.maxVer ?? 0, verified.claims.ver);
+  writeState(paths, state);
+}
+async function loadFleetPolicy(ctx, options = {}) {
+  const state = readState(ctx.paths);
+  const verifyOpts = { expectedSubs: expectedSubs(ctx.enrolment), minVer: state.maxVer };
+  const cached = readCachedPolicies(ctx.paths);
+  let cacheError = null;
+  if (cached.length > 0) {
+    try {
+      const verified = await pickNewestValid(cached, await fleetJwks(ctx), verifyOpts);
+      if (verified.claims.sha256 !== state.appliedSha256 || verified.claims.ver !== state.maxVer) {
+        remember(ctx.paths, state, verified);
+      }
+      return verified;
+    } catch (err) {
+      cacheError = err instanceof Error ? err : new FleetPolicyError(String(err));
+    }
+  }
+  try {
+    const fetched = await fetchFleetPolicy(
+      ctx.enrolment,
+      null,
+      options.fetchTimeoutMs ?? FLEET_SYNC_BUDGET_MS
+    );
+    if (fetched.status === "ok") {
+      const verified = await acceptFetched(ctx, fetched, verifyOpts);
+      remember(ctx.paths, state, verified);
+      return verified;
+    }
+  } catch (err) {
+    if (err instanceof FleetApiError && err.code === "DEVICE_REVOKED") {
+      state.revoked = true;
+      writeState(ctx.paths, state);
+    }
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new FleetPolicyError(
+      cacheError ? `${cacheError.message}; refresh failed (${detail})` : `no fleet policy (${detail})`
+    );
+  }
+  throw cacheError ?? new FleetPolicyError("no fleet policy available");
+}
+async function recordDecisionAndHeartbeat(ctx, applied, decision, options) {
+  const now = options.now ?? Date.now;
+  const state = readState(ctx.paths);
+  if (decision) state.counts[decision] += 1;
+  const intervalSec = applied.settings.heartbeatIntervalSec ?? ctx.enrolment.heartbeatIntervalSec ?? DEFAULT_HEARTBEAT_INTERVAL_SEC;
+  const last = state.lastHeartbeatAt ? Date.parse(state.lastHeartbeatAt) : 0;
+  if (now() - last < intervalSec * 1e3) {
+    writeState(ctx.paths, state);
+    return "throttled";
+  }
+  const deadline = now() + (options.budgetMs ?? FLEET_SYNC_BUDGET_MS);
+  const remaining = () => Math.max(1, deadline - now());
+  state.lastHeartbeatAt = new Date(now()).toISOString();
+  let outcome = "sent";
+  try {
+    const hb = await sendHeartbeat(
+      ctx.enrolment,
+      {
+        appliedSha256: applied.claims.sha256,
+        guardVersion: options.guardVersion,
+        adapters: [{ kind: options.adapterKind, managed: true }],
+        posture: applied.settings.posture,
+        decisionCounts: { ...state.counts }
+      },
+      remaining()
+    );
+    state.counts = { allow: 0, deny: 0, ask: 0 };
+    state.revoked = false;
+    delete state.lastError;
+    const policyChanged = !!hb.activeSha256 && hb.activeSha256 !== applied.claims.sha256;
+    const keyChanged = !!hb.activeKid && !!applied.kid && hb.activeKid !== applied.kid;
+    if (policyChanged || keyChanged) {
+      const fetched = await fetchFleetPolicy(
+        ctx.enrolment,
+        policyEtag(applied.claims.sha256, applied.kid),
+        remaining()
+      );
+      if (fetched.status === "ok") {
+        const verified = await acceptFetched(ctx, fetched, {
+          expectedSubs: expectedSubs(ctx.enrolment),
+          minVer: Math.max(state.maxVer ?? 0, applied.claims.ver)
+        });
+        state.appliedSha256 = verified.claims.sha256;
+        state.maxVer = Math.max(state.maxVer ?? 0, verified.claims.ver);
+        outcome = "refreshed";
+      }
+    }
+  } catch (err) {
+    if (err instanceof FleetApiError && err.code === "DEVICE_REVOKED") {
+      state.revoked = true;
+      outcome = "revoked";
+    } else {
+      state.lastError = err instanceof Error ? err.message : String(err);
+      outcome = "failed";
+    }
+  }
+  writeState(ctx.paths, state);
+  return outcome;
+}
+
+// src/fleet/hook-runner.ts
+var PREFIX = "AstraSync Local Guard (organisation fleet policy)";
+async function runFleetHook(args) {
+  if (args.resolution.kind === "fleet-missing") {
+    return { output: args.denyOutput(`${PREFIX}: ${args.resolution.reason}`), exitCode: 0 };
+  }
+  const ctx = { enrolment: args.resolution.enrolment, paths: args.resolution.paths };
+  let verified;
+  try {
+    verified = await loadFleetPolicy(ctx);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return {
+      output: args.denyOutput(`${PREFIX}: no valid signed policy \u2014 ${detail}`),
+      exitCode: 0
+    };
+  }
+  const { settings } = verified;
+  const decide = async (output) => {
+    try {
+      const outcome = await recordDecisionAndHeartbeat(ctx, verified, args.classify(output), {
+        guardVersion: SDK_VERSION,
+        adapterKind: args.adapterKind,
+        now: args.now
+      });
+      args.onHeartbeat?.(outcome);
+    } catch {
+    }
+    return { output, exitCode: 0 };
+  };
+  let payload;
+  try {
+    payload = JSON.parse(args.payloadJson);
+  } catch {
+    if (settings.failOpen) return decide(null);
+    return decide(args.denyOutput(`${PREFIX}: could not parse hook payload`));
+  }
+  try {
+    const gatewayConfig = {
+      mode: "local",
+      policy: verified.policy,
+      posture: settings.posture,
+      traceEnabled: true,
+      tracePath: (0, import_path5.join)(args.resolution.paths.userDir, "traces"),
+      debug: false
+    };
+    const gateway = args.gatewayFactory ? args.gatewayFactory(gatewayConfig) : new AstraSyncGateway(gatewayConfig);
+    await gateway.initialize();
+    const adapter = args.createAdapter({
+      ...settings.skipTools && { skipTools: settings.skipTools },
+      ...typeof settings.governMcp === "boolean" && { governMcp: settings.governMcp }
+    });
+    await adapter.initialize({ gateway, adapterOptions: {} });
+    const output = await adapter.evaluatePayload(payload);
+    await adapter.shutdown();
+    await gateway.shutdown();
+    return decide(output);
+  } catch (err) {
+    if (settings.failOpen) return decide(null);
+    const detail = err instanceof Error ? err.message : String(err);
+    return decide(args.denyOutput(`${PREFIX}: policy evaluation failed (${detail})`));
+  }
+}
 
 // src/codex/hook.ts
 var MAX_STDIN_BYTES = 1024 * 1024;
@@ -5223,6 +5740,19 @@ function denyOutput(reason) {
 }
 async function processCodexHookPayload(payloadJson, options = {}) {
   const env = options.env ?? process.env;
+  const fleet = resolveFleet(env, options.home ?? (0, import_os3.homedir)(), options.fleetPaths);
+  if (fleet) {
+    return runFleetHook({
+      resolution: fleet,
+      payloadJson,
+      adapterKind: "codex",
+      createAdapter: (adapterOptions) => new CodexAdapter(adapterOptions),
+      denyOutput,
+      classify: (output) => output?.hookSpecificOutput?.permissionDecision === "deny" ? "deny" : output?.hookSpecificOutput?.permissionDecision === "ask" ? "ask" : "allow",
+      gatewayFactory: options.gatewayFactory,
+      now: options.now
+    });
+  }
   if (env.ASTRASYNC_GUARD_DISABLE === "1") {
     return { output: null, exitCode: 0 };
   }
@@ -5255,7 +5785,7 @@ async function processCodexHookPayload(payloadJson, options = {}) {
       policyFile: resolved.policyFile,
       posture: resolved.settings.posture ?? "active",
       traceEnabled: true,
-      tracePath: (0, import_path4.join)(resolved.guardDir, "traces"),
+      tracePath: (0, import_path6.join)(resolved.guardDir, "traces"),
       debug: false,
       ...mode === "hybrid" && {
         apiBaseUrl: resolved.settings.apiBaseUrl,
@@ -5330,8 +5860,8 @@ if (typeof require !== "undefined" && require.main === module) {
 }
 
 // src/claude-code/settings-installer.ts
-var import_fs5 = require("fs");
-var import_path5 = require("path");
+var import_fs6 = require("fs");
+var import_path7 = require("path");
 var ASTRASYNC_HOOK_MARKER = "astrasync-claude-hook";
 var HOOK_MATCHER = "Bash|PowerShell|Write|Edit|MultiEdit|NotebookEdit|Read|Glob|Grep|WebFetch|WebSearch|Task|Agent|mcp__.*";
 var HOOK_TIMEOUT_SECONDS = 10;
@@ -5341,14 +5871,14 @@ function isGuardEntry(entry, marker2) {
   );
 }
 function readSettings(settingsPath) {
-  if (!(0, import_fs5.existsSync)(settingsPath)) return {};
-  const content = (0, import_fs5.readFileSync)(settingsPath, "utf-8").trim();
+  if (!(0, import_fs6.existsSync)(settingsPath)) return {};
+  const content = (0, import_fs6.readFileSync)(settingsPath, "utf-8").trim();
   if (!content) return {};
   return JSON.parse(content);
 }
 function writeSettings(settingsPath, settings) {
-  (0, import_fs5.mkdirSync)((0, import_path5.dirname)(settingsPath), { recursive: true });
-  (0, import_fs5.writeFileSync)(settingsPath, `${JSON.stringify(settings, null, 2)}
+  (0, import_fs6.mkdirSync)((0, import_path7.dirname)(settingsPath), { recursive: true });
+  (0, import_fs6.writeFileSync)(settingsPath, `${JSON.stringify(settings, null, 2)}
 `, "utf-8");
 }
 function buildHookEntry(hookCommand, matcher = HOOK_MATCHER, extraHookFields = {}) {
@@ -5383,7 +5913,7 @@ function installClaudeHooks(settingsPath, hookCommand, marker2 = ASTRASYNC_HOOK_
   return { installed: true, alreadyPresent: false, updated: false };
 }
 function uninstallClaudeHooks(settingsPath, marker2 = ASTRASYNC_HOOK_MARKER) {
-  if (!(0, import_fs5.existsSync)(settingsPath)) return false;
+  if (!(0, import_fs6.existsSync)(settingsPath)) return false;
   let settings;
   try {
     settings = readSettings(settingsPath);
@@ -5409,7 +5939,15 @@ var PERMISSION_DENY_PATHS = [
   "~/.claude/settings.json",
   "~/.claude/settings.local.json",
   "**/.astrasync/**",
-  "~/.astrasync/**"
+  "~/.astrasync/**",
+  // 5.11.0 fleet mode: enrolment + signed-policy cache (user scope is inside
+  // ~/.astrasync already; listed explicitly so the intent survives edits) and
+  // the machine-scope enrolment dirs. `//` = absolute from filesystem root;
+  // Windows paths are matched in POSIX form (C:\ → /c/).
+  "~/.astrasync/fleet/**",
+  "//etc/astrasync/**",
+  "//Library/Application Support/AstraSync/**",
+  "//c/ProgramData/AstraSync/**"
 ];
 var GUARD_PERMISSION_DENY_RULES = PERMISSION_DENY_PATHS.map(
   (p) => `Edit(${p})`