@atbash/sdk 0.10.7-dev.0 → 0.10.10-dev.0

package/dist/index.js

@@ -2864,6 +2864,8 @@ __export(src_ts_exports, {
   DEFAULT_MEMORY_READ_TOOL_NAMES: () => DEFAULT_MEMORY_READ_TOOL_NAMES,
   DEFAULT_MEMORY_WRITE_TOOL_NAMES: () => DEFAULT_MEMORY_WRITE_TOOL_NAMES,
   EciesDomain: () => EciesDomain,
+  HttpClient: () => HttpClient,
+  HttpTransportError: () => HttpTransportError,
   KEY_FILENAMES: () => KEY_FILENAMES,
   MemoryGuardManager: () => MemoryGuardManager,
   MemoryIntegrityError: () => MemoryIntegrityError,
@@ -3109,8 +3111,8 @@ var HttpClient = class {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     this.timeoutMs = timeoutMs;
   }
-  buildUrl(path6, query) {
-    const url = new URL(this.baseUrl + path6);
+  buildUrl(path7, query) {
+    const url = new URL(this.baseUrl + path7);
     if (query) {
       for (const [k, v] of Object.entries(query)) {
         if (v !== void 0 && v !== null && v !== "") {
@@ -3120,23 +3122,83 @@ var HttpClient = class {
     }
     return url.toString();
   }
-  async get(path6, query, headers) {
-    return this.fetch(this.buildUrl(path6, query), {
+  async get(path7, query, headers) {
+    return this.fetch(this.buildUrl(path7, query), {
       method: "GET",
       ...headers && { headers }
     });
   }
-  async post(path6, body, headers) {
-    return this.fetch(this.buildUrl(path6), {
+  async post(path7, body, headers) {
+    return this.fetch(this.buildUrl(path7), {
       method: "POST",
       headers: { "Content-Type": "application/json", ...headers },
       body: JSON.stringify(body)
     });
   }
   async fetch(url, init4) {
-    return fetch(url, { ...init4, signal: AbortSignal.timeout(this.timeoutMs) });
+    try {
+      return await fetch(url, {
+        ...init4,
+        signal: AbortSignal.timeout(this.timeoutMs)
+      });
+    } catch (err) {
+      throw classifyTransportError(err, url, init4.method ?? "GET", this.timeoutMs);
+    }
+  }
+};
+var HttpTransportError = class extends Error {
+  kind;
+  constructor(kind, message, options) {
+    super(message, options);
+    this.name = "HttpTransportError";
+    this.kind = kind;
   }
 };
+function classifyTransportError(err, url, method, timeoutMs) {
+  const name2 = err instanceof Error ? err.name : "";
+  const cause = err instanceof Error ? err.cause : void 0;
+  const code2 = cause && typeof cause === "object" && "code" in cause ? String(cause.code) : "";
+  if (name2 === "TimeoutError") {
+    return new HttpTransportError(
+      "timeout",
+      `${method} ${url} did not respond within ${timeoutMs} ms \u2014 the judge may be slow to boot or the LLM is under load; retry in a moment`,
+      { cause: err }
+    );
+  }
+  if (name2 === "AbortError") {
+    return new HttpTransportError(
+      "aborted",
+      `${method} ${url} was cancelled by the caller`,
+      { cause: err }
+    );
+  }
+  if (code2 === "ENOTFOUND" || code2 === "EAI_AGAIN") {
+    return new HttpTransportError(
+      "dns",
+      `could not resolve the judge hostname (${url}) \u2014 check the endpoint and DNS`,
+      { cause: err }
+    );
+  }
+  if (code2 === "ECONNREFUSED") {
+    return new HttpTransportError(
+      "connect_refused",
+      `judge refused the connection (${url}) \u2014 the service may be down or restarting`,
+      { cause: err }
+    );
+  }
+  if (code2 === "ECONNRESET" || code2 === "EPIPE") {
+    return new HttpTransportError(
+      "connection_reset",
+      `judge dropped the connection mid-request (${url}) \u2014 retry once`,
+      { cause: err }
+    );
+  }
+  return new HttpTransportError(
+    "unknown",
+    `${method} ${url} failed: ${err instanceof Error ? err.message : String(err)}`,
+    { cause: err }
+  );
+}
 
 // src-ts/keyLoader.ts
 var import_node_fs = require("fs");
@@ -3400,6 +3462,16 @@ var Atbash = class _Atbash {
    * calls don't re-hit the dashboard. Cleared by `clearChainCache()`.
    */
   _chainCache = /* @__PURE__ */ new Map();
+  /**
+   * Short-TTL cache for `/api/ai/exists`. The `registered` field is
+   * monotonic (once true, stays true), so most calls in a burst re-fetch
+   * data that hasn't changed. The `org_encryption_pubkey` field CAN change
+   * — an org toggling encryption mid-session — so the TTL is deliberately
+   * short (see `AGENT_EXISTS_TTL_MS`). Keyed by (pubkey, network) so
+   * cross-agent / cross-network calls don't collide.
+   */
+  _agentExistsCache = null;
+  static AGENT_EXISTS_TTL_MS = 5e3;
   /**
    * Cached bearer token for risk-engine / insurance read calls. Built
    * lazily as a signed `log_tool_call` tx and refreshed every 4 min so
@@ -3419,7 +3491,7 @@ var Atbash = class _Atbash {
     this.failClosed = options.failClosed !== false;
     this.debug = options.debug === true;
     this.logger = options.logger ?? {};
-    this.http = new HttpClient(this.endpoint, options.timeoutMs ?? 3e4);
+    this.http = new HttpClient(this.endpoint, options.timeoutMs ?? 6e4);
     this.logEnvironmentOnce();
     if (this.endpoint !== DEFAULT_ENDPOINT) {
       this.logger.warn?.("[atbash] running on non-default judge endpoint", {
@@ -3499,9 +3571,18 @@ var Atbash = class _Atbash {
    */
   async checkAgentExists(pubkey, opts) {
     const pk = pubkey ?? this.auth.pubkey;
+    const network = opts?.network;
+    const now = Date.now();
+    const cached = this._agentExistsCache;
+    if (cached && cached.pubkey === pk && cached.network === network && cached.expiresAt > now) {
+      if (pk === this.auth.pubkey) {
+        this._orgKeyFromChain = cached.orgKey;
+      }
+      return cached.registered;
+    }
     return this.track("checkAgentExists", pk, async () => {
       const query = { pubkey: pk };
-      if (opts?.network) query.network = opts.network;
+      if (network) query.network = network;
       const resp = await this.http.get(
         "/api/ai/exists",
         query,
@@ -3509,11 +3590,21 @@ var Atbash = class _Atbash {
       );
       await this.raiseIfError(resp);
       const data = await this.json(resp);
+      const registered = Boolean(data?.registered);
+      const orgKey = typeof data?.org_encryption_pubkey === "string" && data.org_encryption_pubkey ? data.org_encryption_pubkey : null;
+      if (registered) {
+        this._agentExistsCache = {
+          pubkey: pk,
+          network,
+          expiresAt: Date.now() + _Atbash.AGENT_EXISTS_TTL_MS,
+          registered,
+          orgKey
+        };
+      }
       if (pk === this.auth.pubkey) {
-        const key3 = data?.org_encryption_pubkey;
-        this._orgKeyFromChain = typeof key3 === "string" && key3 ? key3 : null;
+        this._orgKeyFromChain = orgKey;
       }
-      return Boolean(data?.registered);
+      return registered;
     });
   }
   /* ── log_tool_call (sign-only) ─────────────────────────────────────────── */
@@ -3594,12 +3685,19 @@ var Atbash = class _Atbash {
     }
     let chainOpts = options.chainOpts;
     if (options.orgName) {
-      const mapNetwork = await this.getActiveNetworkForOrg(options.orgName);
-      if (mapNetwork) {
-        chainOpts = { network: mapNetwork };
-      } else if (!chainOpts?.blockchainRid) {
-        const resolved = await this.resolveChainFromMap(options.orgName, null);
-        chainOpts = { ...chainOpts, network: resolved.network };
+      const cached = this._chainCache.get(options.orgName);
+      if (cached) {
+        chainOpts = { network: cached.network };
+      } else {
+        const mapNetwork = await this.getActiveNetworkForOrg(options.orgName);
+        if (mapNetwork) {
+          const chain = mapNetwork === "private" ? PRIVATE_CHAIN : PUBLIC_CHAIN;
+          this._chainCache.set(options.orgName, chain);
+          chainOpts = { network: mapNetwork };
+        } else if (!chainOpts?.blockchainRid) {
+          const resolved = await this.resolveChainFromMap(options.orgName, null);
+          chainOpts = { ...chainOpts, network: resolved.network };
+        }
       }
     }
     const brid = this.bridFromChainOpts(chainOpts);
@@ -4048,6 +4146,10 @@ var Atbash = class _Atbash {
   clearChainCache() {
     this._chainCache.clear();
   }
+  /** Drop the short-TTL `/api/ai/exists` cache. Useful in tests. */
+  clearAgentExistsCache() {
+    this._agentExistsCache = null;
+  }
   /* ── internals ─────────────────────────────────────────────────────────── */
   /**
    * Wrap an SDK method body in telemetry — records the call at start
@@ -4150,8 +4252,27 @@ var Atbash = class _Atbash {
       this.endpoint
     );
   }
-  /** Wrap a *transport* failure (fetch threw, no response) as an AtbashAPIError. */
+  /**
+   * Wrap a transport failure (fetch threw, no response) as an AtbashAPIError.
+   *
+   * `HttpTransportError.kind` names the cause; the message is already
+   * human-readable. `debug` echoes the original exception so operators can
+   * cross-reference with node / undici logs when a class doesn't match.
+   */
   transportError(err) {
+    if (err instanceof HttpTransportError) {
+      if (this.debug) {
+        this.logger.warn?.(
+          `[atbash] transport failed \u2014 kind=${err.kind}`,
+          {
+            kind: err.kind,
+            cause: err.cause instanceof Error ? err.cause.message : String(err.cause ?? ""),
+            endpoint: this.endpoint
+          }
+        );
+      }
+      return new AtbashAPIError(0, err.message, "", this.endpoint);
+    }
     return new AtbashAPIError(0, errorMessage(err), "", this.endpoint);
   }
   async json(resp) {
@@ -4378,24 +4499,29 @@ async function scanMemory(entry, auth, opts) {
     toolArgsJson: opts?.toolArgsJson ?? JSON.stringify({ key: entry.key, source: entry.source }),
     mode: "memory-scan"
   });
-  const knownAction = result.actionType === "allow" || result.actionType === "block" || result.actionType === "hold_for_user_confirm";
-  const missingVerdict = result.verdict === "No verdict" && result.status !== "logged";
-  const unknownAction = result.actionType !== "" && !knownAction;
-  if (missingVerdict || unknownAction) {
-    return {
-      safe: false,
-      verdict: "red",
-      reason: unknownAction ? `judge returned unrecognised action_type "${result.actionType}"` : "judge returned no verdict",
-      confidence: result.confidence,
-      score: native.defaultScoreForVerdict("red"),
-      toolCallId: result.toolCallId
-    };
+  if (result.verdict === "No verdict" && result.status !== "logged") {
+    throw new Error(
+      `memory scan: judge returned no verdict without an audit-tier marker (status: ${result.status || "absent"})`
+    );
   }
-  const verdict = native.mapVerdict(
-    result.actionType,
+  const KNOWN_ACTIONS = ["allow", "block", "hold_for_user_confirm"];
+  const action = result.actionType.trim().toLowerCase();
+  if (result.verdict !== "No verdict" && !KNOWN_ACTIONS.includes(action)) {
+    throw new Error(
+      `memory scan: unrecognized action_type from judge (${result.actionType || "absent"})`
+    );
+  }
+  const mapped = native.mapVerdict(
+    action,
     result.confidence,
     threshold
   );
+  let verdict = mapped;
+  if (result.verdict === "BLOCK") {
+    verdict = "red";
+  } else if (result.verdict === "HOLD" && mapped === "green") {
+    verdict = "yellow";
+  }
   const parsed = native.parseScoreFromReason(result.reason);
   const score = result.score ?? parsed.score ?? native.defaultScoreForVerdict(verdict);
   return {
@@ -9301,8 +9427,8 @@ Reporter$3.prototype.wrapResult = function wrapResult(result) {
     errors: state2.errors
   };
 };
-function ReporterError$1(path6, msg) {
-  this.path = path6;
+function ReporterError$1(path7, msg) {
+  this.path = path7;
   this.rethrow(msg);
 }
 inherits$v(ReporterError$1, Error);
@@ -29523,8 +29649,8 @@ Reporter.prototype.wrapResult = function wrapResult2(result) {
     errors: state2.errors
   };
 };
-function ReporterError(path6, msg) {
-  this.path = path6;
+function ReporterError(path7, msg) {
+  this.path = path7;
   this.rethrow(msg);
 }
 inherits(ReporterError, Error);
@@ -32554,8 +32680,8 @@ var parseUtil = {};
   const errors_js_12 = errors$3;
   const en_js_12 = __importDefault2(en);
   const makeIssue = (params) => {
-    const { data, path: path6, errorMaps, issueData } = params;
-    const fullPath = [...path6, ...issueData.path || []];
+    const { data, path: path7, errorMaps, issueData } = params;
+    const fullPath = [...path7, ...issueData.path || []];
     const fullIssue = {
       ...issueData,
       path: fullPath
@@ -32692,11 +32818,11 @@ var errorUtil_js_1 = errorUtil$1;
 var parseUtil_js_1 = parseUtil;
 var util_js_1 = util;
 var ParseInputLazyPath = class {
-  constructor(parent, value, path6, key3) {
+  constructor(parent, value, path7, key3) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path6;
+    this._path = path7;
     this._key = key3;
   }
   get path() {
@@ -39602,21 +39728,21 @@ function createTimeoutController(timeout) {
   const timeoutId = setTimeout(() => controller.abort(timeoutError), timeout);
   return { controller, timeoutId };
 }
-function handleRequest(method, path6, endpoint, timeout, postObject) {
+function handleRequest(method, path7, endpoint, timeout, postObject) {
   return __awaiter$2(this, void 0, void 0, function* () {
     if (method == enums_1$2.Method.GET) {
-      return yield get(path6, endpoint, timeout);
+      return yield get(path7, endpoint, timeout);
     } else {
-      return yield post(path6, endpoint, timeout, postObject);
+      return yield post(path7, endpoint, timeout, postObject);
     }
   });
 }
-function get(path6, endpoint, timeout) {
+function get(path7, endpoint, timeout) {
   return __awaiter$2(this, void 0, void 0, function* () {
-    logger.debug(`GET URL ${new URL(path6, endpoint).href}`);
+    logger.debug(`GET URL ${new URL(path7, endpoint).href}`);
     try {
       const { controller, timeoutId } = createTimeoutController(timeout);
-      const response = yield fetch(new URL(path6, endpoint).href, {
+      const response = yield fetch(new URL(path7, endpoint).href, {
         signal: controller === null || controller === void 0 ? void 0 : controller.signal
       });
       if (timeoutId)
@@ -39654,9 +39780,9 @@ function constructBufferResponseBody(response) {
     return responseText ? responseText : response.statusText;
   });
 }
-function post(path6, endpoint, timeout, requestBody) {
+function post(path7, endpoint, timeout, requestBody) {
   return __awaiter$2(this, void 0, void 0, function* () {
-    logger.debug(`POST URL ${new URL(path6, endpoint).href}`);
+    logger.debug(`POST URL ${new URL(path7, endpoint).href}`);
     logger.debug(`POST body ${JSON.stringify(requestBody)}`);
     if (buffer_1.Buffer.isBuffer(requestBody)) {
       try {
@@ -39670,7 +39796,7 @@ function post(path6, endpoint, timeout, requestBody) {
           },
           signal: controller === null || controller === void 0 ? void 0 : controller.signal
         };
-        const response = yield fetch(new URL(path6, endpoint).href, requestOptions);
+        const response = yield fetch(new URL(path7, endpoint).href, requestOptions);
         if (timeoutId)
           clearTimeout(timeoutId);
         const transactionTimestamp = response.headers.get("X-Transaction-Timestamp");
@@ -39681,7 +39807,7 @@ function post(path6, endpoint, timeout, requestBody) {
     } else {
       try {
         const { controller, timeoutId } = createTimeoutController(timeout);
-        const response = yield fetch(new URL(path6, endpoint).href, {
+        const response = yield fetch(new URL(path7, endpoint).href, {
           method: "post",
           body: JSON.stringify(requestBody),
           headers: {
@@ -39861,10 +39987,10 @@ function requireFailoverStrategies() {
       }
     }
     function abortOnError(_a2) {
-      return __awaiter2(this, arguments, void 0, function* ({ method, path: path6, config: config2, postObject, timeoutOverride }) {
+      return __awaiter2(this, arguments, void 0, function* ({ method, path: path7, config: config2, postObject, timeoutOverride }) {
         return yield retryRequest({
           method,
-          path: path6,
+          path: path7,
           config: config2,
           postObject,
           timeoutOverride,
@@ -39875,10 +40001,10 @@ function requireFailoverStrategies() {
       });
     }
     function tryNextOnError(_a2) {
-      return __awaiter2(this, arguments, void 0, function* ({ method, path: path6, config: config2, postObject, timeoutOverride }) {
+      return __awaiter2(this, arguments, void 0, function* ({ method, path: path7, config: config2, postObject, timeoutOverride }) {
         return yield retryRequest({
           method,
-          path: path6,
+          path: path7,
           config: config2,
           postObject,
           timeoutOverride,
@@ -39894,7 +40020,7 @@ function requireFailoverStrategies() {
       return endpointPoolLength - (endpointPoolLength - 1) / 3;
     }
     function queryMajority(_a2) {
-      return __awaiter2(this, arguments, void 0, function* ({ method, path: path6, config: config2, postObject, timeoutOverride }) {
+      return __awaiter2(this, arguments, void 0, function* ({ method, path: path7, config: config2, postObject, timeoutOverride }) {
         var _b;
         const bftMajorityThreshold = calculateBftMajorityThreshold(config2.endpointPool.length);
         const failureThreshold = config2.endpointPool.length - bftMajorityThreshold + 1;
@@ -39905,7 +40031,7 @@ function requireFailoverStrategies() {
         const promises = availableNodes.map((node2) => __awaiter2(this, void 0, void 0, function* () {
           try {
             const requestTimeout = timeoutOverride !== null && timeoutOverride !== void 0 ? timeoutOverride : config2.responseTimeout;
-            const response = yield (0, httpUtil_1.handleRequest)(method, path6, node2.url, requestTimeout, postObject);
+            const response = yield (0, httpUtil_1.handleRequest)(method, path7, node2.url, requestTimeout, postObject);
             const { statusCode } = response;
             if (statusCode && (0, http_utils_1.isSuccessfulStatusCode)(statusCode)) {
               outcomes.push({ type: "SUCCESS", result: response });
@@ -39952,7 +40078,7 @@ function requireFailoverStrategies() {
       });
     }
     function singleEndpoint(_a2) {
-      return __awaiter2(this, arguments, void 0, function* ({ method, path: path6, config: config2, postObject, timeoutOverride }) {
+      return __awaiter2(this, arguments, void 0, function* ({ method, path: path7, config: config2, postObject, timeoutOverride }) {
         let statusCode = null;
         let rspBody = null;
         let error4 = null;
@@ -39963,7 +40089,7 @@ function requireFailoverStrategies() {
         }
         for (let attempt = 0; attempt < config2.attemptsPerEndpoint; attempt++) {
           const requestTimeout = timeoutOverride !== null && timeoutOverride !== void 0 ? timeoutOverride : config2.responseTimeout;
-          const response = yield (0, httpUtil_1.handleRequest)(method, path6, endpoint.url, requestTimeout, postObject);
+          const response = yield (0, httpUtil_1.handleRequest)(method, path7, endpoint.url, requestTimeout, postObject);
           if (response) {
             ({ error: error4, statusCode, rspBody, transactionTimestamp } = response);
           }
@@ -39978,7 +40104,7 @@ function requireFailoverStrategies() {
       });
     }
     function retryRequest(_a2) {
-      return __awaiter2(this, arguments, void 0, function* ({ method, path: path6, config: config2, postObject, useNextNodeOnError, recoveryThreshold, timeoutOverride }) {
+      return __awaiter2(this, arguments, void 0, function* ({ method, path: path7, config: config2, postObject, useNextNodeOnError, recoveryThreshold, timeoutOverride }) {
         var _b, _c, _d;
         let statusCode = null;
         let rspBody = null;
@@ -39989,7 +40115,7 @@ function requireFailoverStrategies() {
         for (const node2 of availableNodes) {
           for (let attempt = 0; attempt < config2.attemptsPerEndpoint; attempt++) {
             const requestTimeout = timeoutOverride !== null && timeoutOverride !== void 0 ? timeoutOverride : config2.responseTimeout;
-            const response = yield (0, httpUtil_1.handleRequest)(method, path6, node2.url, requestTimeout, postObject);
+            const response = yield (0, httpUtil_1.handleRequest)(method, path7, node2.url, requestTimeout, postObject);
             error4 = (_b = response === null || response === void 0 ? void 0 : response.error) !== null && _b !== void 0 ? _b : null;
             statusCode = (_c = response === null || response === void 0 ? void 0 : response.statusCode) !== null && _c !== void 0 ? _c : null;
             rspBody = (_d = response === null || response === void 0 ? void 0 : response.rspBody) !== null && _d !== void 0 ? _d : null;
@@ -40132,19 +40258,19 @@ function requireRequestWithFailoverStrategy() {
   const enums_12 = enums;
   const failoverStrategies_1 = requireFailoverStrategies();
   function requestWithFailoverStrategy$1(method_1, path_1, config_1, postObject_1) {
-    return __awaiter2(this, arguments, void 0, function* (method, path6, config2, postObject, forceSingleEndpoint = false, timeoutOverride) {
+    return __awaiter2(this, arguments, void 0, function* (method, path7, config2, postObject, forceSingleEndpoint = false, timeoutOverride) {
       switch (config2.failoverStrategy) {
         case enums_12.FailoverStrategy.AbortOnError:
-          return yield (0, failoverStrategies_1.abortOnError)({ method, path: path6, config: config2, postObject, timeoutOverride });
+          return yield (0, failoverStrategies_1.abortOnError)({ method, path: path7, config: config2, postObject, timeoutOverride });
         case enums_12.FailoverStrategy.TryNextOnError:
-          return yield (0, failoverStrategies_1.tryNextOnError)({ method, path: path6, config: config2, postObject, timeoutOverride });
+          return yield (0, failoverStrategies_1.tryNextOnError)({ method, path: path7, config: config2, postObject, timeoutOverride });
         case enums_12.FailoverStrategy.SingleEndpoint:
-          return yield (0, failoverStrategies_1.singleEndpoint)({ method, path: path6, config: config2, postObject, timeoutOverride });
+          return yield (0, failoverStrategies_1.singleEndpoint)({ method, path: path7, config: config2, postObject, timeoutOverride });
         case enums_12.FailoverStrategy.QueryMajority:
           if (forceSingleEndpoint) {
-            return yield (0, failoverStrategies_1.singleEndpoint)({ method, path: path6, config: config2, postObject, timeoutOverride });
+            return yield (0, failoverStrategies_1.singleEndpoint)({ method, path: path7, config: config2, postObject, timeoutOverride });
           }
-          return yield (0, failoverStrategies_1.queryMajority)({ method, path: path6, config: config2, postObject, timeoutOverride });
+          return yield (0, failoverStrategies_1.queryMajority)({ method, path: path7, config: config2, postObject, timeoutOverride });
         default:
           throw new Error(`Unsupported failover strategy: ${config2.failoverStrategy}`);
       }
@@ -41343,7 +41469,7 @@ var networkSettings = {};
     const restNetworkSettingsValidationContext = RestNetworkSettingsSchema.safeParse(networkSettings2);
     if ("error" in restNetworkSettingsValidationContext) {
       const { error: { issues } = {} } = restNetworkSettingsValidationContext;
-      const errorMessage2 = issues === null || issues === void 0 ? void 0 : issues.map(({ message, path: path6 }) => `${path6[0]}: ${message}`).join(", ");
+      const errorMessage2 = issues === null || issues === void 0 ? void 0 : issues.map(({ message, path: path7 }) => `${path7[0]}: ${message}`).join(", ");
       if (throwOnError) {
         throw new Error(errorMessage2);
       }
@@ -42725,6 +42851,7 @@ function classifyMemoryWrite(event, ctx, opts = {}) {
 }
 
 // src-ts/memory/guard.ts
+var import_node_path4 = __toESM(require("path"));
 function emitDebugProbe(event, ctx, memEntry, logger2) {
   if (!logger2?.info) return;
   const ev = event ?? {};
@@ -42761,7 +42888,8 @@ async function guardMemoryWrite(input) {
     toolNames,
     enforce = true,
     debug: debug2 = false,
-    logger: logger2
+    logger: logger2,
+    memoryFilePath
   } = input;
   const memEntry = classifyMemoryWrite(event, ctx, { patterns, toolNames });
   if (debug2) emitDebugProbe(event, ctx, memEntry, logger2);
@@ -42797,17 +42925,28 @@ async function guardMemoryWrite(input) {
       committed: false
     };
   }
-  commitMemoryVersion(memEntry.value, auth, {
-    score: scanResult.score,
-    orgName,
-    endpoint
-  }).catch((err) => {
-    const reason = err instanceof Error ? err.message : String(err);
-    logger2?.warn?.("[atbash] memory commit to chain failed", {
-      path: memEntry.key,
-      reason
+  const isManagedMemoryFile = memoryFilePath !== void 0 && import_node_path4.default.resolve(memEntry.key) === import_node_path4.default.resolve(memoryFilePath);
+  if (isManagedMemoryFile) {
+    commitMemoryVersion(memEntry.value, auth, {
+      score: scanResult.score,
+      orgName,
+      endpoint
+    }).catch((err) => {
+      const reason = err instanceof Error ? err.message : String(err);
+      logger2?.warn?.("[atbash] memory commit to chain failed", {
+        path: memEntry.key,
+        reason
+      });
     });
-  });
+  } else {
+    logger2?.info?.(
+      "[atbash] scanned but not committed \u2014 not the managed memory file",
+      {
+        path: memEntry.key,
+        memoryFilePath: memoryFilePath ?? "(not configured)"
+      }
+    );
+  }
   logger2?.info?.(
     scanResult.verdict === "yellow" ? "[atbash] memory HOLD" : "[atbash] memory ALLOW",
     { path: memEntry.key, score: scanResult.score, reason: scanResult.reason }
@@ -42816,7 +42955,7 @@ async function guardMemoryWrite(input) {
     handled: true,
     decision: { allow: true },
     scanResult,
-    committed: true
+    committed: isManagedMemoryFile
   };
 }
 
@@ -42835,26 +42974,26 @@ async function syncLocalMemory(auth, pointer, opts = {}) {
   const now = Date.now();
   const withinTtl = !opts.force && now - pointer.checkedAt < ttl;
   if (withinTtl) {
-    return { drifted: false, pointer };
+    return { drifted: false, checked: false, pointer };
   }
   const currentId = await getActiveMemoryId(auth, opts.chainOpts);
   const nextPointer = { activeId: currentId, checkedAt: now };
   if (currentId === pointer.activeId) {
-    return { drifted: false, pointer: nextPointer };
+    return { drifted: false, checked: true, pointer: nextPointer };
   }
   if (currentId === null) {
-    return { drifted: true, current: null, pointer: nextPointer };
+    return { drifted: true, checked: true, current: null, pointer: nextPointer };
   }
   const row = await getMemoryById(currentId, auth, opts.chainOpts);
   if (row.decryptError) {
     throw new MemoryIntegrityError(currentId, row.decryptError);
   }
-  return { drifted: true, current: row, pointer: nextPointer };
+  return { drifted: true, checked: true, current: row, pointer: nextPointer };
 }
 
 // src-ts/memory/pointer-store.ts
 var import_node_fs4 = require("fs");
-var import_node_path4 = __toESM(require("path"));
+var import_node_path5 = __toESM(require("path"));
 var EMPTY = { version: 1, agents: {} };
 var PointerStore = class {
   constructor(filePath) {
@@ -42896,19 +43035,19 @@ var PointerStore = class {
     this.cache = { ...EMPTY, agents: {} };
   }
   async persist(file) {
-    await import_node_fs4.promises.mkdir(import_node_path4.default.dirname(this.filePath), { recursive: true });
+    await import_node_fs4.promises.mkdir(import_node_path5.default.dirname(this.filePath), { recursive: true });
     const tmp = `${this.filePath}.${process.pid}.tmp`;
     await import_node_fs4.promises.writeFile(tmp, JSON.stringify(file, null, 2), "utf8");
     await import_node_fs4.promises.rename(tmp, this.filePath);
   }
 };
 function defaultPointerPath(workspaceDir = process.cwd()) {
-  return import_node_path4.default.join(workspaceDir, ".atbash", "memory-pointer.json");
+  return import_node_path5.default.join(workspaceDir, ".atbash", "memory-pointer.json");
 }
 
 // src-ts/memory/file-logger.ts
 var import_node_fs5 = require("fs");
-var import_node_path5 = __toESM(require("path"));
+var import_node_path6 = __toESM(require("path"));
 function formatMeta(meta) {
   if (!meta || Object.keys(meta).length === 0) return "";
   try {
@@ -42920,7 +43059,7 @@ function formatMeta(meta) {
 function createFileLogger(filePath, upstream) {
   let queue = Promise.resolve();
   async function ensureDir() {
-    await import_node_fs5.promises.mkdir(import_node_path5.default.dirname(filePath), { recursive: true });
+    await import_node_fs5.promises.mkdir(import_node_path6.default.dirname(filePath), { recursive: true });
   }
   function append(level, message, meta) {
     const line = `${(/* @__PURE__ */ new Date()).toISOString()} [${level}] ${message}${formatMeta(meta)}
@@ -42940,7 +43079,7 @@ function createFileLogger(filePath, upstream) {
   };
 }
 function defaultPluginLogPath(workspaceDir = process.cwd()) {
-  return import_node_path5.default.join(workspaceDir, ".atbash", "plugin.log");
+  return import_node_path6.default.join(workspaceDir, ".atbash", "plugin.log");
 }
 
 // src-ts/memory/read-classifier.ts
@@ -42955,13 +43094,13 @@ function classifyMemoryRead(event, ctx, opts = {}) {
 
 // src-ts/memory/guard-manager.ts
 var import_node_fs6 = require("fs");
-var import_node_path6 = __toESM(require("path"));
+var import_node_path7 = __toESM(require("path"));
 var DEFAULT_SYNC_TTL_MS = 3e4;
 var MemoryGuardManager = class {
   constructor(opts) {
     this.opts = opts;
     const workspaceDir = opts.workspaceDir;
-    this.memoryFilePath = opts.memoryFilePath ?? import_node_path6.default.join(workspaceDir, "MEMORY.md");
+    this.memoryFilePath = opts.memoryFilePath ?? import_node_path7.default.join(workspaceDir, "MEMORY.md");
     this.pointerStore = new PointerStore(opts.pointerFilePath ?? defaultPointerPath(workspaceDir));
     this.logger = createFileLogger(
       opts.logFilePath ?? defaultPluginLogPath(workspaceDir),
@@ -42991,7 +43130,11 @@ var MemoryGuardManager = class {
   async runBootProbe() {
     try {
       const seed = { activeId: null, checkedAt: 0 };
-      const result = await syncLocalMemory(this.opts.auth, seed, { ttlMs: 0, force: true });
+      const result = await syncLocalMemory(this.opts.auth, seed, {
+        ttlMs: 0,
+        force: true,
+        chainOpts: this.opts.chainOpts
+      });
       if (!result.drifted && result.pointer.activeId == null) {
         this.logger.info(
           `[atbash] no active memory on chain for agent=${this.agentPubkeyHex.slice(0, 16)}\u2026 org=${this.opts.orgName ?? "(none)"} \u2014 either the agent isn't registered on this chain or hasn't written any memory. Sync will remain a no-op until a write lands.`
@@ -43023,15 +43166,19 @@ var MemoryGuardManager = class {
     }
   }
   /**
-   * Returns a `HookDecision` when the event is a memory read or write
-   * (host returns it verbatim to its runtime). Returns `null` when the
-   * event isn't memory-related — host falls through to its own audit.
+   * Returns a `HookDecision` when the guard reached a decision about this event.
+   * Returns `null` when it did not — either the event isn't memory-related, or it
+   * is but the guard could not check it. In both cases the host falls through to
+   * its own audit.
+   *
+   * A returned decision carries `audited` (see `HookDecision`). Only
+   * `{ allow: true, audited: true }` means "checked and cleared"; anything else
+   * that allows is a call the host still needs to judge.
    */
   async handleBeforeToolCall(event, ctx) {
     if (classifyMemoryRead(event, ctx, this.opts.memoryReadClassifier)) {
       this.logger.info("[atbash] memory read intercepted \u2014 running sync check");
-      const readDecision = await this.handleMemoryRead();
-      return readDecision ?? { allow: true };
+      return await this.handleMemoryRead(event, ctx);
     }
     const guardLogger = {
       info: (msg, meta) => this.logger.info(msg, meta && typeof meta === "object" ? meta : void 0),
@@ -43048,7 +43195,9 @@ var MemoryGuardManager = class {
       toolNames: this.opts.memoryWriteToolNames,
       enforce: this.enforce,
       debug: this.opts.debug,
-      logger: guardLogger
+      logger: guardLogger,
+      // Only this file may reach the single, path-less chain memory slot.
+      memoryFilePath: this.memoryFilePath
     });
     return this.mapGuardResult(guard);
   }
@@ -43066,30 +43215,81 @@ var MemoryGuardManager = class {
         block: true,
         blockReason: d.reason ?? "",
         allow: false,
-        reason: d.reason
+        reason: d.reason,
+        // A block IS a decision — the most thoroughly checked one the guard
+        // makes. Without this a host following the documented `!audited ->
+        // judge it yourself` rule would re-judge its way past a red scan.
+        audited: true,
+        ...sr2 ? { verdict: sr2.verdict } : {}
       };
     }
     this.logger.info(
       `[atbash] guardMemoryWrite ALLOWED \u2014 verdict=${verdict} score=${score} committed=${guard.committed === true}`
     );
-    return { allow: true };
+    if (sr2 === void 0) {
+      return { allow: true, audited: false, reason: "memory scan did not run (observe mode)" };
+    }
+    if (sr2.verdict !== "green") {
+      return {
+        allow: true,
+        audited: false,
+        verdict: sr2.verdict,
+        reason: `memory scan returned ${sr2.verdict} but this guard is not enforcing it`
+      };
+    }
+    return { allow: true, audited: true, verdict: sr2.verdict };
   }
-  async handleMemoryRead() {
+  /**
+   * Whether the pointer state this manager tracks actually describes the file
+   * this call is about to read.
+   *
+   * The classifier fires on nine patterns — including the bare tokens
+   * `"memory/"`, `"CLAUDE.md"` and `"AGENTS.md"` — but the sync path only ever
+   * reads, refreshes, or vouches for `this.memoryFilePath`. Without this check a
+   * read of `/repo/CLAUDE.md` (or any path merely containing `memory/`) would
+   * receive an `audited: true` for a file the guard never opened.
+   *
+   * Conservative on purpose: every path-shaped value found must resolve to the
+   * managed file. If none is found, or any one differs, the answer is no. That
+   * also covers events carrying two different path keys, where the classifier
+   * and the host could otherwise disagree about which one is authoritative.
+   */
+  vouchesForTarget(event, ctx) {
+    const KEYS = ["path", "file_path", "filePath", "notebook_path", "notebookPath", "target"];
+    const found = [];
+    for (const src of [event, ctx]) {
+      for (const bag of [src, src?.params]) {
+        if (!bag || typeof bag !== "object") continue;
+        const rec = bag;
+        for (const k of KEYS) {
+          if (typeof rec[k] === "string" && rec[k]) found.push(rec[k]);
+        }
+      }
+    }
+    if (found.length === 0) return false;
+    const managed = import_node_path7.default.resolve(this.memoryFilePath);
+    return found.every((p) => import_node_path7.default.resolve(p) === managed);
+  }
+  async handleMemoryRead(event, ctx) {
     const pointer = await this.pointerStore.get(this.agentPubkeyHex);
     let result;
     try {
-      result = await syncLocalMemory(this.opts.auth, pointer, { ttlMs: this.ttlMs });
+      result = await syncLocalMemory(this.opts.auth, pointer, {
+        ttlMs: this.ttlMs,
+        chainOpts: this.opts.chainOpts
+      });
     } catch (err) {
       if (err instanceof MemoryIntegrityError) {
         const reason = `Memory integrity check failed on id ${err.id} \u2014 read blocked.`;
         this.logger.warn("[atbash] MEMORY INTEGRITY FAILURE", { id: err.id, error: err.message });
         if (!this.enforce) return null;
-        return { block: true, blockReason: reason, allow: false, reason };
+        return { block: true, blockReason: reason, allow: false, reason, audited: true };
       }
       const msg = err instanceof Error ? err.message : String(err);
       this.logger.warn("[atbash] memory sync failed (serving local copy)", { error: msg });
       return null;
     }
+    let onDiskIsCurrent = result.checked;
     if (result.drifted) {
       const fresh = result.current;
       if (fresh) {
@@ -43097,7 +43297,7 @@ var MemoryGuardManager = class {
           const reason = `Rolled-back memory version #${fresh.id} scored ${fresh.score} (below threshold ${this.rollbackMinScore}) \u2014 read blocked.`;
           this.logger.warn("[atbash] blocking read on low-score rollback", { id: fresh.id, score: fresh.score });
           if (!this.enforce) return null;
-          return { block: true, blockReason: reason, allow: false, reason };
+          return { block: true, blockReason: reason, allow: false, reason, audited: true };
         }
         this.logger.info("[atbash] memory drift detected \u2014 refreshing local file", {
           id: fresh.id,
@@ -43108,16 +43308,26 @@ var MemoryGuardManager = class {
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
           this.logger.warn("[atbash] failed to write refreshed memory (serving old)", { error: msg });
+          onDiskIsCurrent = false;
         }
       } else {
         this.logger.info("[atbash] active memory removed on chain", { pubkey: this.agentPubkeyHex });
+        onDiskIsCurrent = false;
       }
     }
-    await this.pointerStore.set(this.agentPubkeyHex, result.pointer);
-    return null;
+    if (onDiskIsCurrent) {
+      await this.pointerStore.set(this.agentPubkeyHex, result.pointer);
+    } else {
+      this.logger.warn(
+        "[atbash] not advancing memory pointer \u2014 local file is stale or revoked; reads stay unaudited until it is refreshed"
+      );
+    }
+    if (!onDiskIsCurrent) return null;
+    if (!this.vouchesForTarget(event, ctx)) return null;
+    return { allow: true, audited: true };
   }
   async writeMemoryAtomic(content) {
-    await import_node_fs6.promises.mkdir(import_node_path6.default.dirname(this.memoryFilePath), { recursive: true });
+    await import_node_fs6.promises.mkdir(import_node_path7.default.dirname(this.memoryFilePath), { recursive: true });
     const tmp = `${this.memoryFilePath}.${process.pid}.tmp`;
     await import_node_fs6.promises.writeFile(tmp, content, "utf8");
     await import_node_fs6.promises.rename(tmp, this.memoryFilePath);
@@ -43256,6 +43466,8 @@ function diffMemorySnapshots(before, after) {
   DEFAULT_MEMORY_READ_TOOL_NAMES,
   DEFAULT_MEMORY_WRITE_TOOL_NAMES,
   EciesDomain,
+  HttpClient,
+  HttpTransportError,
   KEY_FILENAMES,
   MemoryGuardManager,
   MemoryIntegrityError,