@hashgraphonline/standards-sdk 0.1.144 → 0.1.145

package/dist/es/standards-sdk.es135.js

@@ -1,329 +1,467 @@
-import { createSessionResponseSchema, chatHistoryCompactionResponseSchema, sessionEncryptionStatusResponseSchema, encryptionHandshakeResponseSchema, sendMessageResponseSchema } from "./standards-sdk.es157.js";
-import { RegistryBrokerClient } from "./standards-sdk.es136.js";
-import { serialiseAuthConfig, toJsonObject } from "./standards-sdk.es158.js";
-import { EncryptionUnavailableError, EncryptedChatManager } from "./standards-sdk.es159.js";
-const encryptedManagers = /* @__PURE__ */ new WeakMap();
-const chatApis = /* @__PURE__ */ new WeakMap();
-function getEncryptedChatManager(client) {
-  const existing = encryptedManagers.get(client);
-  if (existing) {
-    return existing;
-  }
-  const created = new EncryptedChatManager(client);
-  encryptedManagers.set(client, created);
-  return created;
-}
-Object.defineProperty(RegistryBrokerClient.prototype, "chat", {
-  get() {
-    const existing = chatApis.get(this);
-    if (existing) {
-      return existing;
-    }
-    const encryptedManager = getEncryptedChatManager(this);
-    const api = {
-      start: (options) => this.startChat(options),
-      createSession: (payload) => this.createSession(payload),
-      sendMessage: (payload) => this.sendMessage(payload),
-      endSession: (sessionId) => this.endSession(sessionId),
-      getHistory: (sessionId, options) => this.fetchHistorySnapshot(sessionId, options),
-      compactHistory: (payload) => this.compactHistory(payload),
-      getEncryptionStatus: (sessionId) => this.fetchEncryptionStatus(sessionId),
-      submitEncryptionHandshake: (sessionId, payload) => this.postEncryptionHandshake(sessionId, payload),
-      startConversation: (options) => this.startConversation(options),
-      acceptConversation: (options) => this.acceptConversation(options),
-      createEncryptedSession: (options) => encryptedManager.startSession(options),
-      acceptEncryptedSession: (options) => encryptedManager.acceptSession(options)
+import { Buffer } from "buffer";
+import { randomBytes, createHash, createCipheriv, createDecipheriv } from "crypto";
+import { secp256k1 } from "@noble/curves/secp256k1.js";
+import { ZodError } from "zod";
+import { agentFeedbackResponseSchema, agentFeedbackIndexResponseSchema, agentFeedbackEntriesIndexResponseSchema, agentFeedbackEligibilityResponseSchema, agentFeedbackSubmissionResponseSchema } from "./standards-sdk.es149.js";
+import { DEFAULT_BASE_URL, normaliseBaseUrl, normaliseHeaderName, isBrowserRuntime, DEFAULT_USER_AGENT, JSON_CONTENT_TYPE, createAbortError, isJsonObject, DEFAULT_HISTORY_TOP_UP_HBAR } from "./standards-sdk.es159.js";
+import { RegistryBrokerError, RegistryBrokerParseError } from "./standards-sdk.es136.js";
+class RegistryBrokerClient {
+  constructor(options = {}) {
+    this.encryptionBootstrapPromise = null;
+    const {
+      baseUrl = DEFAULT_BASE_URL,
+      fetchImplementation,
+      defaultHeaders,
+      apiKey,
+      ledgerApiKey,
+      registrationAutoTopUp,
+      historyAutoTopUp,
+      encryption
+    } = options;
+    this.baseUrl = normaliseBaseUrl(baseUrl);
+    this.fetchImpl = fetchImplementation ?? fetch;
+    this.defaultHeaders = {
+      ...defaultHeaders ?? {}
     };
-    chatApis.set(this, api);
-    return api;
+    Object.entries(this.defaultHeaders).forEach(([key, value]) => {
+      const headerName = normaliseHeaderName(key);
+      if (headerName !== key) {
+        delete this.defaultHeaders[key];
+        this.defaultHeaders[headerName] = value;
+      }
+    });
+    if (apiKey) {
+      this.defaultHeaders["x-api-key"] = apiKey;
+    }
+    if (ledgerApiKey) {
+      this.defaultHeaders["x-ledger-api-key"] = ledgerApiKey;
+    }
+    this.registrationAutoTopUp = registrationAutoTopUp;
+    this.historyAutoTopUp = historyAutoTopUp;
+    this.encryptionOptions = encryption;
+    if (this.encryptionOptions) {
+      this.encryptionBootstrapPromise = this.initializeEncryptionBootstrap(
+        this.encryptionOptions
+      );
+    }
   }
-});
-RegistryBrokerClient.prototype.createSession = async function(payload, allowHistoryAutoTopUp = true) {
-  const body = {};
-  if ("uaid" in payload && payload.uaid) {
-    body.uaid = payload.uaid;
+  static async initializeAgent(options) {
+    const { uaid, ensureEncryptionKey = true, ...clientOptions } = options;
+    const client = new RegistryBrokerClient(clientOptions);
+    let encryption = null;
+    if (ensureEncryptionKey) {
+      const ensureOptions = typeof ensureEncryptionKey === "object" ? ensureEncryptionKey : { generateIfMissing: true };
+      encryption = await client.encryption.ensureAgentKey({
+        uaid,
+        ...ensureOptions
+      });
+    }
+    return { client, encryption };
   }
-  if ("agentUrl" in payload && payload.agentUrl) {
-    body.agentUrl = payload.agentUrl;
+  setApiKey(apiKey) {
+    this.setDefaultHeader("x-api-key", apiKey);
   }
-  if (payload.auth) {
-    body.auth = serialiseAuthConfig(payload.auth);
+  setLedgerApiKey(apiKey) {
+    this.setDefaultHeader("x-ledger-api-key", apiKey);
   }
-  if (payload.historyTtlSeconds !== void 0) {
-    body.historyTtlSeconds = payload.historyTtlSeconds;
+  setDefaultHeader(name, value) {
+    if (!name || name.trim().length === 0) {
+      return;
+    }
+    const headerName = normaliseHeaderName(name);
+    if (!value || value.trim().length === 0) {
+      delete this.defaultHeaders[headerName];
+      return;
+    }
+    this.defaultHeaders[headerName] = value.trim();
   }
-  if (payload.encryptionRequested !== void 0) {
-    body.encryptionRequested = payload.encryptionRequested;
+  getDefaultHeaders() {
+    return { ...this.defaultHeaders };
   }
-  if (payload.senderUaid) {
-    body.senderUaid = payload.senderUaid;
+  async encryptionReady() {
+    if (!this.encryptionBootstrapPromise) {
+      return;
+    }
+    await this.encryptionBootstrapPromise;
+  }
+  buildUrl(path) {
+    const normalisedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${this.baseUrl}${normalisedPath}`;
   }
-  try {
-    const raw = await this.requestJson("/chat/session", {
-      method: "POST",
-      body,
-      headers: { "content-type": "application/json" }
+  async request(path, config) {
+    const headers = new Headers();
+    Object.entries(this.defaultHeaders).forEach(([key, value]) => {
+      headers.set(key, value);
     });
+    if (config.headers) {
+      Object.entries(config.headers).forEach(([key, value]) => {
+        headers.set(key, value);
+      });
+    }
+    if (!headers.has("accept")) {
+      headers.set("accept", "application/json");
+    }
+    if (!headers.has("user-agent") && !isBrowserRuntime()) {
+      headers.set("user-agent", DEFAULT_USER_AGENT);
+    }
+    const init = {
+      method: config.method ?? "GET",
+      headers
+    };
+    if (config.body !== void 0) {
+      init.body = JSON.stringify(config.body);
+      if (!headers.has("content-type")) {
+        headers.set("content-type", "application/json");
+      }
+    }
+    const response = await this.fetchImpl(this.buildUrl(path), init);
+    if (response.ok) {
+      return response;
+    }
+    const errorBody = await this.extractErrorBody(response);
+    throw new RegistryBrokerError("Registry broker request failed", {
+      status: response.status,
+      statusText: response.statusText,
+      body: errorBody
+    });
+  }
+  async requestJson(path, config) {
+    const response = await this.request(path, config);
+    const contentType = response.headers?.get("content-type") ?? "";
+    if (!JSON_CONTENT_TYPE.test(contentType)) {
+      const body = await response.text();
+      throw new RegistryBrokerParseError(
+        "Expected JSON response from registry broker",
+        body
+      );
+    }
+    return await response.json();
+  }
+  async getAgentFeedback(uaid, options = {}) {
+    const normalized = uaid.trim();
+    if (!normalized) {
+      throw new Error("uaid is required");
+    }
+    const query = options.includeRevoked === true ? "?includeRevoked=true" : "";
+    const raw = await this.requestJson(
+      `/agents/${encodeURIComponent(normalized)}/feedback${query}`,
+      { method: "GET" }
+    );
     return this.parseWithSchema(
       raw,
-      createSessionResponseSchema,
-      "chat session response"
+      agentFeedbackResponseSchema,
+      "agent feedback response"
     );
-  } catch (error) {
-    const maybeError = error instanceof Error ? error : null;
-    if (allowHistoryAutoTopUp && this.shouldAutoTopUpHistory(payload, maybeError)) {
-      await this.executeHistoryAutoTopUp("chat.session");
-      return this.createSession(payload, false);
-    }
-    throw error;
   }
-};
-RegistryBrokerClient.prototype.startChat = async function(options) {
-  if ("uaid" in options && options.uaid) {
-    return this.startConversation({
-      uaid: options.uaid,
-      senderUaid: options.senderUaid,
-      historyTtlSeconds: options.historyTtlSeconds,
-      auth: options.auth,
-      encryption: options.encryption,
-      onSessionCreated: options.onSessionCreated
+  async listAgentFeedbackIndex(options = {}) {
+    const params = new URLSearchParams();
+    if (typeof options.page === "number" && Number.isFinite(options.page)) {
+      params.set("page", String(Math.trunc(options.page)));
+    }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.trunc(options.limit)));
+    }
+    if (options.registries?.length) {
+      params.set("registry", options.registries.join(","));
+    }
+    const suffix = params.size > 0 ? `?${params.toString()}` : "";
+    const raw = await this.requestJson(`/agents/feedback${suffix}`, {
+      method: "GET"
     });
+    return this.parseWithSchema(
+      raw,
+      agentFeedbackIndexResponseSchema,
+      "agent feedback index response"
+    );
   }
-  if ("agentUrl" in options && options.agentUrl) {
-    const session = await this.createSession({
-      agentUrl: options.agentUrl,
-      auth: options.auth,
-      historyTtlSeconds: options.historyTtlSeconds,
-      senderUaid: options.senderUaid
-    });
-    options.onSessionCreated?.(session.sessionId);
-    return this.createPlaintextConversationHandle(
-      session.sessionId,
-      session.encryption ?? null,
-      options.auth,
-      { agentUrl: options.agentUrl, uaid: options.uaid }
+  async listAgentFeedbackEntriesIndex(options = {}) {
+    const params = new URLSearchParams();
+    if (typeof options.page === "number" && Number.isFinite(options.page)) {
+      params.set("page", String(Math.trunc(options.page)));
+    }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.trunc(options.limit)));
+    }
+    if (options.registries?.length) {
+      params.set("registry", options.registries.join(","));
+    }
+    const suffix = params.size > 0 ? `?${params.toString()}` : "";
+    const raw = await this.requestJson(
+      `/agents/feedback/entries${suffix}`,
+      { method: "GET" }
+    );
+    return this.parseWithSchema(
+      raw,
+      agentFeedbackEntriesIndexResponseSchema,
+      "agent feedback entries index response"
     );
   }
-  throw new Error("startChat requires either uaid or agentUrl");
-};
-RegistryBrokerClient.prototype.startConversation = async function(options) {
-  const preference = options.encryption?.preference ?? "preferred";
-  const requestEncryption = preference !== "disabled";
-  if (!requestEncryption) {
-    const session = await this.createSession({
-      uaid: options.uaid,
-      auth: options.auth,
-      historyTtlSeconds: options.historyTtlSeconds,
-      senderUaid: options.senderUaid,
-      encryptionRequested: false
-    });
-    options.onSessionCreated?.(session.sessionId);
-    return this.createPlaintextConversationHandle(
-      session.sessionId,
-      session.encryption ?? null,
-      options.auth,
-      { uaid: options.uaid }
+  async checkAgentFeedbackEligibility(uaid, payload) {
+    const normalized = uaid.trim();
+    if (!normalized) {
+      throw new Error("uaid is required");
+    }
+    const raw = await this.requestJson(
+      `/agents/${encodeURIComponent(normalized)}/feedback/eligibility`,
+      {
+        method: "POST",
+        body: payload,
+        headers: { "content-type": "application/json" }
+      }
+    );
+    return this.parseWithSchema(
+      raw,
+      agentFeedbackEligibilityResponseSchema,
+      "agent feedback eligibility response"
     );
   }
-  try {
-    const encryptedManager = getEncryptedChatManager(this);
-    const handle = await encryptedManager.startSession({
-      uaid: options.uaid,
-      senderUaid: options.senderUaid,
-      historyTtlSeconds: options.historyTtlSeconds,
-      handshakeTimeoutMs: options.encryption?.handshakeTimeoutMs,
-      pollIntervalMs: options.encryption?.pollIntervalMs,
-      onSessionCreated: (sessionId) => {
-        options.onSessionCreated?.(sessionId);
-      },
-      auth: options.auth
-    });
-    return handle;
-  } catch (error) {
-    if (error instanceof EncryptionUnavailableError) {
-      if (preference === "required") {
-        throw error;
+  async submitAgentFeedback(uaid, payload) {
+    const normalized = uaid.trim();
+    if (!normalized) {
+      throw new Error("uaid is required");
+    }
+    const raw = await this.requestJson(
+      `/agents/${encodeURIComponent(normalized)}/feedback`,
+      {
+        method: "POST",
+        body: payload,
+        headers: { "content-type": "application/json" }
       }
-      return this.createPlaintextConversationHandle(
-        error.sessionId,
-        error.summary ?? null,
-        options.auth,
-        { uaid: options.uaid }
-      );
+    );
+    return this.parseWithSchema(
+      raw,
+      agentFeedbackSubmissionResponseSchema,
+      "agent feedback submission response"
+    );
+  }
+  async extractErrorBody(response) {
+    const contentType = response.headers?.get("content-type") ?? "";
+    if (JSON_CONTENT_TYPE.test(contentType)) {
+      try {
+        return await response.json();
+      } catch (error) {
+        return { parseError: String(error) };
+      }
+    }
+    try {
+      return await response.text();
+    } catch (error) {
+      return { parseError: String(error) };
     }
-    throw error;
   }
-};
-RegistryBrokerClient.prototype.acceptConversation = async function(options) {
-  const preference = options.encryption?.preference ?? "preferred";
-  if (preference === "disabled") {
-    return this.createPlaintextConversationHandle(options.sessionId, null);
-  }
-  try {
-    const encryptedManager = getEncryptedChatManager(this);
-    const handle = await encryptedManager.acceptSession({
-      sessionId: options.sessionId,
-      responderUaid: options.responderUaid,
-      handshakeTimeoutMs: options.encryption?.handshakeTimeoutMs,
-      pollIntervalMs: options.encryption?.pollIntervalMs
-    });
-    return handle;
-  } catch (error) {
-    if (error instanceof EncryptionUnavailableError && preference !== "required") {
-      return this.createPlaintextConversationHandle(
-        options.sessionId,
-        null,
-        void 0,
-        { uaid: options.responderUaid }
+  parseWithSchema(value, schema, context) {
+    try {
+      return schema.parse(value);
+    } catch (error) {
+      throw new RegistryBrokerParseError(
+        `Failed to parse ${context}`,
+        error instanceof ZodError || error instanceof Error ? error : String(error),
+        value
       );
     }
-    throw error;
   }
-};
-RegistryBrokerClient.prototype.createPlaintextConversationHandle = function(sessionId, summary, defaultAuth, context) {
-  const uaid = context?.uaid?.trim();
-  const agentUrl = context?.agentUrl?.trim();
-  return {
-    sessionId,
-    mode: "plaintext",
-    summary: summary ?? null,
-    send: async (options) => {
-      const plaintext = options.plaintext;
-      if (!plaintext || plaintext.trim().length === 0) {
-        throw new Error("plaintext is required for chat messages");
+  async delay(ms, signal) {
+    if (ms <= 0) {
+      if (signal?.aborted) {
+        throw createAbortError();
       }
-      const message = options.message ?? plaintext;
-      return this.sendMessage({
-        sessionId,
-        message,
-        streaming: options.streaming,
-        auth: options.auth ?? defaultAuth,
-        uaid,
-        agentUrl
-      });
-    },
-    decryptHistoryEntry: (entry) => entry.content
-  };
-};
-RegistryBrokerClient.prototype.compactHistory = async function(payload) {
-  if (!payload.sessionId || payload.sessionId.trim().length === 0) {
-    throw new Error("sessionId is required to compact chat history");
-  }
-  const body = {};
-  if (typeof payload.preserveEntries === "number" && Number.isFinite(payload.preserveEntries) && payload.preserveEntries >= 0) {
-    body.preserveEntries = Math.floor(payload.preserveEntries);
-  }
-  const raw = await this.requestJson(
-    `/chat/session/${encodeURIComponent(payload.sessionId)}/compact`,
-    {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body
-    }
-  );
-  return this.parseWithSchema(
-    raw,
-    chatHistoryCompactionResponseSchema,
-    "chat history compaction response"
-  );
-};
-RegistryBrokerClient.prototype.fetchEncryptionStatus = async function(sessionId) {
-  if (!sessionId || sessionId.trim().length === 0) {
-    throw new Error("sessionId is required for encryption status");
-  }
-  const raw = await this.requestJson(
-    `/chat/session/${encodeURIComponent(sessionId)}/encryption`,
-    {
-      method: "GET"
+      return;
     }
-  );
-  return this.parseWithSchema(
-    raw,
-    sessionEncryptionStatusResponseSchema,
-    "session encryption status response"
-  );
-};
-RegistryBrokerClient.prototype.postEncryptionHandshake = async function(sessionId, payload) {
-  if (!sessionId || sessionId.trim().length === 0) {
-    throw new Error("sessionId is required for encryption handshake");
-  }
-  const raw = await this.requestJson(
-    `/chat/session/${encodeURIComponent(sessionId)}/encryption-handshake`,
-    {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: {
-        role: payload.role,
-        keyType: payload.keyType,
-        ephemeralPublicKey: payload.ephemeralPublicKey,
-        longTermPublicKey: payload.longTermPublicKey,
-        signature: payload.signature,
-        uaid: payload.uaid,
-        userId: payload.userId,
-        ledgerAccountId: payload.ledgerAccountId,
-        metadata: payload.metadata
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        if (signal) {
+          signal.removeEventListener("abort", onAbort);
+        }
+        resolve();
+      }, ms);
+      const onAbort = () => {
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
+        reject(createAbortError());
+      };
+      if (signal) {
+        if (signal.aborted) {
+          clearTimeout(timer);
+          reject(createAbortError());
+          return;
+        }
+        signal.addEventListener("abort", onAbort, { once: true });
       }
+    });
+  }
+  assertNodeRuntime(feature) {
+    if (typeof process === "undefined" || !process.versions?.node) {
+      throw new Error(`${feature} is only available in Node.js environments`);
     }
-  );
-  const response = this.parseWithSchema(
-    raw,
-    encryptionHandshakeResponseSchema,
-    "encryption handshake response"
-  );
-  return response.handshake;
-};
-RegistryBrokerClient.prototype.sendMessage = async function(payload) {
-  const body = {
-    message: payload.message
-  };
-  if (payload.streaming !== void 0) {
-    body.streaming = payload.streaming;
-  }
-  if (payload.auth) {
-    body.auth = serialiseAuthConfig(payload.auth);
-  }
-  if ("uaid" in payload) {
-    body.uaid = payload.uaid;
-  }
-  if ("sessionId" in payload && payload.sessionId) {
-    body.sessionId = payload.sessionId;
-  }
-  if ("agentUrl" in payload && payload.agentUrl) {
-    body.agentUrl = payload.agentUrl;
-  }
-  let cipherEnvelope = payload.cipherEnvelope ?? null;
-  if (payload.encryption) {
-    const sessionIdForEncryption = payload.encryption.sessionId ?? (typeof body.sessionId === "string" ? body.sessionId : void 0);
-    if (!sessionIdForEncryption) {
-      throw new Error(
-        "sessionId is required when using encrypted chat payloads"
-      );
+  }
+  createEphemeralKeyPair() {
+    this.assertNodeRuntime("generateEphemeralKeyPair");
+    const privateKeyBytes = randomBytes(32);
+    const publicKey = secp256k1.getPublicKey(privateKeyBytes, true);
+    return {
+      privateKey: Buffer.from(privateKeyBytes).toString("hex"),
+      publicKey: Buffer.from(publicKey).toString("hex")
+    };
+  }
+  deriveSharedSecret(options) {
+    this.assertNodeRuntime("deriveSharedSecret");
+    const privateKey = this.hexToBuffer(options.privateKey);
+    const peerPublicKey = this.hexToBuffer(options.peerPublicKey);
+    const shared = secp256k1.getSharedSecret(privateKey, peerPublicKey, true);
+    return createHash("sha256").update(Buffer.from(shared)).digest();
+  }
+  buildCipherEnvelope(options) {
+    this.assertNodeRuntime("encryptCipherEnvelope");
+    const sharedSecret = this.normalizeSharedSecret(options.sharedSecret);
+    const iv = randomBytes(12);
+    const cipher = createCipheriv("aes-256-gcm", sharedSecret, iv);
+    const aadSource = options.associatedData ?? options.sessionId;
+    const associatedDataEncoded = aadSource ? Buffer.from(aadSource, "utf8").toString("base64") : void 0;
+    if (aadSource) {
+      cipher.setAAD(Buffer.from(aadSource, "utf8"));
+    }
+    const ciphertext = Buffer.concat([
+      cipher.update(Buffer.from(options.plaintext, "utf8")),
+      cipher.final()
+    ]);
+    const tag = cipher.getAuthTag();
+    const payload = Buffer.concat([ciphertext, tag]);
+    return {
+      algorithm: "aes-256-gcm",
+      ciphertext: payload.toString("base64"),
+      nonce: iv.toString("base64"),
+      associatedData: associatedDataEncoded,
+      keyLocator: {
+        sessionId: options.sessionId,
+        revision: options.revision ?? 1
+      },
+      recipients: options.recipients.map((recipient) => ({
+        ...recipient,
+        encryptedShare: ""
+      }))
+    };
+  }
+  openCipherEnvelope(options) {
+    this.assertNodeRuntime("decryptCipherEnvelope");
+    const sharedSecret = this.normalizeSharedSecret(options.sharedSecret);
+    const payload = Buffer.from(options.envelope.ciphertext, "base64");
+    const nonce = Buffer.from(options.envelope.nonce, "base64");
+    const ciphertext = payload.slice(0, payload.length - 16);
+    const tag = payload.slice(payload.length - 16);
+    const decipher = createDecipheriv("aes-256-gcm", sharedSecret, nonce);
+    if (options.envelope.associatedData) {
+      decipher.setAAD(Buffer.from(options.envelope.associatedData, "base64"));
     }
-    if (!payload.encryption.recipients?.length) {
-      throw new Error("recipients are required for encrypted chat payloads");
+    decipher.setAuthTag(tag);
+    const plaintext = Buffer.concat([
+      decipher.update(ciphertext),
+      decipher.final()
+    ]);
+    return plaintext.toString(options.encoding ?? "utf8");
+  }
+  normalizeSharedSecret(input) {
+    if (Buffer.isBuffer(input)) {
+      return Buffer.from(input);
+    }
+    if (input instanceof Uint8Array) {
+      return Buffer.from(input);
+    }
+    if (typeof input === "string") {
+      return this.bufferFromString(input);
+    }
+    throw new Error("Unsupported shared secret input");
+  }
+  bufferFromString(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+      throw new Error("sharedSecret string cannot be empty");
+    }
+    const normalized = trimmed.startsWith("0x") ? trimmed.slice(2) : trimmed;
+    if (/^[0-9a-fA-F]+$/.test(normalized) && normalized.length % 2 === 0) {
+      return Buffer.from(normalized, "hex");
+    }
+    return Buffer.from(trimmed, "base64");
+  }
+  hexToBuffer(value) {
+    const normalized = value.startsWith("0x") ? value.slice(2) : value;
+    if (!/^[0-9a-fA-F]+$/.test(normalized) || normalized.length % 2 !== 0) {
+      throw new Error("Expected hex-encoded value");
+    }
+    return Buffer.from(normalized, "hex");
+  }
+  extractInsufficientCreditsDetails(error) {
+    if (!(error instanceof RegistryBrokerError) || error.status !== 402) {
+      return null;
+    }
+    const body = error.body;
+    if (!body || typeof body !== "object" || Array.isArray(body)) {
+      return null;
+    }
+    const maybeShortfall = body["shortfallCredits"];
+    if (typeof maybeShortfall !== "number" || maybeShortfall <= 0) {
+      return null;
+    }
+    return { shortfallCredits: maybeShortfall };
+  }
+  extractErrorMessage(body) {
+    if (typeof body === "string") {
+      return body;
     }
-    cipherEnvelope = this.encryption.encryptCipherEnvelope({
-      ...payload.encryption,
-      sessionId: sessionIdForEncryption
+    if (isJsonObject(body) && typeof body.error === "string") {
+      return body.error;
+    }
+    if (isJsonObject(body) && typeof body.message === "string") {
+      return body.message;
+    }
+    return void 0;
+  }
+  shouldAutoTopUpHistory(payload, error) {
+    if (!this.historyAutoTopUp || payload.historyTtlSeconds === void 0) {
+      return false;
+    }
+    if (!(error instanceof RegistryBrokerError)) {
+      return false;
+    }
+    if (error.status !== 402) {
+      return false;
+    }
+    const message = this.extractErrorMessage(error.body);
+    if (!message) {
+      return true;
+    }
+    const normalised = message.toLowerCase();
+    return normalised.includes("history") || normalised.includes("chat history");
+  }
+  async executeHistoryAutoTopUp(reason) {
+    if (!this.historyAutoTopUp) {
+      return;
+    }
+    const hbarAmount = this.historyAutoTopUp.hbarAmount && this.historyAutoTopUp.hbarAmount > 0 ? this.historyAutoTopUp.hbarAmount : DEFAULT_HISTORY_TOP_UP_HBAR;
+    await this.purchaseCreditsWithHbar({
+      accountId: this.historyAutoTopUp.accountId,
+      privateKey: this.historyAutoTopUp.privateKey,
+      hbarAmount,
+      memo: this.historyAutoTopUp.memo ?? "registry-broker-client:chat-history-topup",
+      metadata: {
+        purpose: "chat-history",
+        reason
+      }
     });
   }
-  if (cipherEnvelope) {
-    body.cipherEnvelope = toJsonObject(cipherEnvelope);
-  }
-  const raw = await this.requestJson("/chat/message", {
-    method: "POST",
-    body,
-    headers: { "content-type": "application/json" }
-  });
-  return this.parseWithSchema(
-    raw,
-    sendMessageResponseSchema,
-    "chat message response"
-  );
-};
-RegistryBrokerClient.prototype.endSession = async function(sessionId) {
-  await this.request(`/chat/session/${encodeURIComponent(sessionId)}`, {
-    method: "DELETE"
-  });
+  initializeEncryptionBootstrap(options) {
+    return this.bootstrapEncryptionOptions(options).then(() => void 0);
+  }
+  bootstrapEncryptionOptions(_options) {
+    return Promise.resolve(null);
+  }
+}
+const isPendingRegisterAgentResponse = (response) => response.status === "pending";
+const isPartialRegisterAgentResponse = (response) => response.status === "partial" && response.success === false;
+const isSuccessRegisterAgentResponse = (response) => response.success === true && response.status !== "pending";
+export {
+  RegistryBrokerClient,
+  isPartialRegisterAgentResponse,
+  isPendingRegisterAgentResponse,
+  isSuccessRegisterAgentResponse
 };
 //# sourceMappingURL=standards-sdk.es135.js.map