@hashgraphonline/standards-sdk 0.1.147 → 0.1.148

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

@@ -1,242 +1,334 @@
-const DEFAULT_USER_AGENT = "@hol-org/rb-client";
-const DEFAULT_PROGRESS_INTERVAL_MS = 1500;
-const DEFAULT_PROGRESS_TIMEOUT_MS = 5 * 60 * 1e3;
-const DEFAULT_BASE_URL = "https://hol.org/registry/api/v1";
-const JSON_CONTENT_TYPE = /application\/json/i;
-const DEFAULT_HISTORY_TOP_UP_HBAR = 0.25;
-const MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS = 1;
-const stripTrailingSlashes = (value) => {
-  let end = value.length;
-  while (end > 0 && value.charCodeAt(end - 1) === 47) {
-    end -= 1;
-  }
-  return end === value.length ? value : value.slice(0, end);
-};
-const createAbortError = () => typeof DOMException === "function" ? new DOMException("Aborted", "AbortError") : new Error("The operation was aborted");
-const normaliseHeaderName = (name) => name.trim().toLowerCase();
-const isBrowserRuntime = () => typeof window !== "undefined" && typeof window.fetch === "function";
-const toJsonValue = (value) => {
-  if (value === null) {
-    return null;
-  }
-  if (value instanceof Date) {
-    return value.toISOString();
-  }
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-    return value;
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => item === void 0 ? null : toJsonValue(item));
-  }
-  if (typeof value === "object") {
-    const result = {};
-    Object.entries(value).forEach(
-      ([key, entryValue]) => {
-        if (entryValue !== void 0) {
-          result[key] = toJsonValue(entryValue);
-        }
-      }
-    );
-    return result;
-  }
-  throw new TypeError("Only JSON-compatible values are supported");
-};
-const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const toJsonObject = (value) => {
-  const normalised = toJsonValue(value);
-  if (isJsonObject(normalised)) {
-    return normalised;
-  }
-  throw new TypeError("Expected JSON object value");
-};
-const serialiseAuthConfig = (auth) => {
-  const authPayload = {};
-  if (auth.type) {
-    authPayload.type = auth.type;
-  }
-  if (auth.token) {
-    authPayload.token = auth.token;
-  }
-  if (auth.username) {
-    authPayload.username = auth.username;
-  }
-  if (auth.password) {
-    authPayload.password = auth.password;
-  }
-  if (auth.headerName) {
-    authPayload.headerName = auth.headerName;
+import { createSessionResponseSchema, chatHistoryCompactionResponseSchema, sessionEncryptionStatusResponseSchema, encryptionHandshakeResponseSchema, sendMessageResponseSchema } from "./standards-sdk.es127.js";
+import { serialiseAuthConfig, toJsonObject } from "./standards-sdk.es154.js";
+import { EncryptionUnavailableError } from "./standards-sdk.es161.js";
+function createChatApi(client, encryptedManager) {
+  return {
+    start: (options) => client.startChat(options),
+    createSession: (payload) => client.createSession(payload),
+    sendMessage: (payload) => client.sendMessage(payload),
+    endSession: (sessionId) => client.endSession(sessionId),
+    getHistory: (sessionId, options) => client.fetchHistorySnapshot(sessionId, options),
+    compactHistory: (payload) => client.compactHistory(payload),
+    getEncryptionStatus: (sessionId) => client.fetchEncryptionStatus(sessionId),
+    submitEncryptionHandshake: (sessionId, payload) => client.postEncryptionHandshake(sessionId, payload),
+    startConversation: (options) => client.startConversation(options),
+    acceptConversation: (options) => client.acceptConversation(options),
+    createEncryptedSession: (options) => encryptedManager.startSession(options),
+    acceptEncryptedSession: (options) => encryptedManager.acceptSession(options)
+  };
+}
+async function createSession(client, payload, allowHistoryAutoTopUp = true) {
+  const body = {};
+  if ("uaid" in payload && payload.uaid) {
+    body.uaid = payload.uaid;
   }
-  if (auth.headerValue) {
-    authPayload.headerValue = auth.headerValue;
+  if ("agentUrl" in payload && payload.agentUrl) {
+    body.agentUrl = payload.agentUrl;
   }
-  if (auth.headers) {
-    authPayload.headers = { ...auth.headers };
+  if (payload.auth) {
+    body.auth = serialiseAuthConfig(payload.auth);
   }
-  return authPayload;
-};
-const serialiseAgentRegistrationRequest = (payload) => {
-  const body = {
-    profile: toJsonObject(payload.profile)
-  };
-  if (payload.endpoint !== void 0) {
-    body.endpoint = payload.endpoint;
+  if (payload.historyTtlSeconds !== void 0) {
+    body.historyTtlSeconds = payload.historyTtlSeconds;
   }
-  if (payload.protocol !== void 0) {
-    body.protocol = payload.protocol;
+  if (payload.encryptionRequested !== void 0) {
+    body.encryptionRequested = payload.encryptionRequested;
   }
-  if (payload.communicationProtocol !== void 0) {
-    body.communicationProtocol = payload.communicationProtocol;
+  if (payload.senderUaid) {
+    body.senderUaid = payload.senderUaid;
   }
-  if (payload.registry !== void 0) {
-    body.registry = payload.registry;
+  try {
+    const raw = await client.requestJson("/chat/session", {
+      method: "POST",
+      body,
+      headers: { "content-type": "application/json" }
+    });
+    return client.parseWithSchema(
+      raw,
+      createSessionResponseSchema,
+      "chat session response"
+    );
+  } catch (error) {
+    const maybeError = error instanceof Error ? error : null;
+    if (allowHistoryAutoTopUp && client.shouldAutoTopUpHistory(payload, maybeError)) {
+      await client.executeHistoryAutoTopUp("chat.session");
+      return createSession(client, payload, false);
+    }
+    throw error;
   }
-  if (payload.additionalRegistries !== void 0) {
-    body.additionalRegistries = payload.additionalRegistries;
+}
+async function startChat(client, encryptedManager, options) {
+  if ("uaid" in options && options.uaid) {
+    return startConversation(client, encryptedManager, {
+      uaid: options.uaid,
+      senderUaid: options.senderUaid,
+      historyTtlSeconds: options.historyTtlSeconds,
+      auth: options.auth,
+      encryption: options.encryption,
+      onSessionCreated: options.onSessionCreated
+    });
   }
-  if (payload.metadata !== void 0) {
-    body.metadata = toJsonObject(payload.metadata);
+  if ("agentUrl" in options && options.agentUrl) {
+    const session = await createSession(client, {
+      agentUrl: options.agentUrl,
+      auth: options.auth,
+      historyTtlSeconds: options.historyTtlSeconds,
+      senderUaid: options.senderUaid
+    });
+    options.onSessionCreated?.(session.sessionId);
+    return createPlaintextConversationHandle(
+      client,
+      session.sessionId,
+      session.encryption ?? null,
+      options.auth,
+      { agentUrl: options.agentUrl, uaid: options.uaid }
+    );
   }
-  return body;
-};
-const normalizeHexPrivateKey = (value) => {
-  const trimmed = value.trim();
-  if (!trimmed) {
-    throw new Error("evmPrivateKey is required");
+  throw new Error("startChat requires either uaid or agentUrl");
+}
+async function startConversation(client, encryptedManager, options) {
+  const preference = options.encryption?.preference ?? "preferred";
+  const requestEncryption = preference !== "disabled";
+  if (!requestEncryption) {
+    const session = await createSession(client, {
+      uaid: options.uaid,
+      auth: options.auth,
+      historyTtlSeconds: options.historyTtlSeconds,
+      senderUaid: options.senderUaid,
+      encryptionRequested: false
+    });
+    options.onSessionCreated?.(session.sessionId);
+    return createPlaintextConversationHandle(
+      client,
+      session.sessionId,
+      session.encryption ?? null,
+      options.auth,
+      { uaid: options.uaid }
+    );
   }
-  return trimmed.startsWith("0x") ? trimmed : `0x${trimmed}`;
-};
-function normaliseBaseUrl(input) {
-  const trimmed = input?.trim();
-  let baseCandidate = trimmed && trimmed.length > 0 ? trimmed : DEFAULT_BASE_URL;
   try {
-    const url = new URL(stripTrailingSlashes(baseCandidate));
-    const hostname = url.hostname.toLowerCase();
-    const ensureRegistryPrefix = () => {
-      if (!url.pathname.startsWith("/registry")) {
-        url.pathname = url.pathname === "/" ? "/registry" : `/registry${url.pathname}`;
+    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;
       }
-    };
-    if (hostname === "hol.org") {
-      ensureRegistryPrefix();
-      baseCandidate = url.toString();
-    } else if (hostname === "registry.hashgraphonline.com" || hostname === "hashgraphonline.com") {
-      ensureRegistryPrefix();
-      url.hostname = "hol.org";
-      baseCandidate = url.toString();
+      return createPlaintextConversationHandle(
+        client,
+        error.sessionId,
+        error.summary ?? null,
+        options.auth,
+        { uaid: options.uaid }
+      );
     }
-  } catch {
+    throw error;
   }
-  const withoutTrailing = stripTrailingSlashes(baseCandidate);
-  if (/\/api\/v\d+$/i.test(withoutTrailing)) {
-    return withoutTrailing;
+}
+async function acceptConversation(client, encryptedManager, options) {
+  const preference = options.encryption?.preference ?? "preferred";
+  if (preference === "disabled") {
+    return createPlaintextConversationHandle(client, options.sessionId, null);
   }
-  if (/\/api$/i.test(withoutTrailing)) {
-    return `${withoutTrailing}/v1`;
+  try {
+    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 createPlaintextConversationHandle(
+        client,
+        options.sessionId,
+        null,
+        void 0,
+        { uaid: options.responderUaid }
+      );
+    }
+    throw error;
   }
-  return `${withoutTrailing}/api/v1`;
 }
-function buildSearchQuery(params) {
-  const query = new URLSearchParams();
-  const appendList = (key, values) => {
-    if (!values) {
-      return;
+function createPlaintextConversationHandle(client, sessionId, summary, defaultAuth, context) {
+  const uaid = context?.uaid?.trim();
+  const agentUrl = context?.agentUrl?.trim();
+  const fetchHistory = async (options) => {
+    const snapshot = await client.fetchHistorySnapshot(sessionId, options);
+    if (snapshot.decryptedHistory) {
+      return snapshot.decryptedHistory;
     }
-    values.forEach((value) => {
-      if (typeof value === "string") {
-        const trimmed = value.trim();
-        if (trimmed.length > 0) {
-          query.append(key, trimmed);
-        }
+    return snapshot.history.map((entry) => ({
+      entry,
+      plaintext: entry.content
+    }));
+  };
+  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");
       }
-    });
+      const message = options.message ?? plaintext;
+      return sendMessage(client, {
+        sessionId,
+        message,
+        streaming: options.streaming,
+        auth: options.auth ?? defaultAuth,
+        uaid,
+        agentUrl
+      });
+    },
+    decryptHistoryEntry: (entry) => entry.content,
+    fetchHistory
   };
-  if (params.q) {
-    const trimmed = params.q.trim();
-    if (trimmed.length > 0) {
-      query.set("q", trimmed);
+}
+async function compactHistory(client, 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 client.requestJson(
+    `/chat/session/${encodeURIComponent(payload.sessionId)}/compact`,
+    {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body
     }
-  }
-  if (typeof params.page === "number") {
-    query.set("page", params.page.toString());
-  }
-  if (typeof params.limit === "number") {
-    query.set("limit", params.limit.toString());
-  }
-  if (params.registry) {
-    const trimmed = params.registry.trim();
-    if (trimmed.length > 0) {
-      query.set("registry", trimmed);
+  );
+  return client.parseWithSchema(
+    raw,
+    chatHistoryCompactionResponseSchema,
+    "chat history compaction response"
+  );
+}
+async function fetchEncryptionStatus(client, sessionId) {
+  if (!sessionId || sessionId.trim().length === 0) {
+    throw new Error("sessionId is required for encryption status");
+  }
+  const raw = await client.requestJson(
+    `/chat/session/${encodeURIComponent(sessionId)}/encryption`,
+    {
+      method: "GET"
     }
-  }
-  appendList("registries", params.registries);
-  if (typeof params.minTrust === "number") {
-    query.set("minTrust", params.minTrust.toString());
-  }
-  appendList("capabilities", params.capabilities);
-  appendList("protocols", params.protocols);
-  appendList("adapters", params.adapters);
-  if (params.metadata) {
-    Object.entries(params.metadata).forEach(([key, values]) => {
-      if (!key || !Array.isArray(values) || values.length === 0) {
-        return;
-      }
-      const trimmedKey = key.trim();
-      if (trimmedKey.length === 0) {
-        return;
+  );
+  return client.parseWithSchema(
+    raw,
+    sessionEncryptionStatusResponseSchema,
+    "session encryption status response"
+  );
+}
+async function postEncryptionHandshake(client, sessionId, payload) {
+  if (!sessionId || sessionId.trim().length === 0) {
+    throw new Error("sessionId is required for encryption handshake");
+  }
+  const raw = await client.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
       }
-      values.forEach((value) => {
-        if (value === void 0 || value === null) {
-          return;
-        }
-        query.append(`metadata.${trimmedKey}`, String(value));
-      });
-    });
-  }
-  if (params.type) {
-    const trimmedType = params.type.trim();
-    if (trimmedType.length > 0 && trimmedType.toLowerCase() !== "all") {
-      query.set("type", trimmedType);
     }
+  );
+  const response = client.parseWithSchema(
+    raw,
+    encryptionHandshakeResponseSchema,
+    "encryption handshake response"
+  );
+  return response.handshake;
+}
+async function sendMessage(client, payload) {
+  const body = {
+    message: payload.message
+  };
+  if (payload.streaming !== void 0) {
+    body.streaming = payload.streaming;
   }
-  if (params.verified === true) {
-    query.set("verified", "true");
+  if (payload.auth) {
+    body.auth = serialiseAuthConfig(payload.auth);
   }
-  if (params.online === true) {
-    query.set("online", "true");
+  if ("uaid" in payload) {
+    body.uaid = payload.uaid;
   }
-  if (params.sortBy) {
-    const trimmedSort = params.sortBy.trim();
-    if (trimmedSort.length > 0) {
-      query.set("sortBy", trimmedSort);
-    }
+  if ("sessionId" in payload && payload.sessionId) {
+    body.sessionId = payload.sessionId;
+  }
+  if ("agentUrl" in payload && payload.agentUrl) {
+    body.agentUrl = payload.agentUrl;
   }
-  if (params.sortOrder) {
-    const lowered = params.sortOrder.toLowerCase();
-    if (lowered === "asc" || lowered === "desc") {
-      query.set("sortOrder", lowered);
+  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"
+      );
     }
+    if (!payload.encryption.recipients?.length) {
+      throw new Error("recipients are required for encrypted chat payloads");
+    }
+    cipherEnvelope = client.encryption.encryptCipherEnvelope({
+      ...payload.encryption,
+      sessionId: sessionIdForEncryption
+    });
   }
-  const queryString = query.toString();
-  return queryString.length > 0 ? `?${queryString}` : "";
+  if (cipherEnvelope) {
+    body.cipherEnvelope = toJsonObject(cipherEnvelope);
+  }
+  const raw = await client.requestJson("/chat/message", {
+    method: "POST",
+    body,
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    sendMessageResponseSchema,
+    "chat message response"
+  );
+}
+async function endSession(client, sessionId) {
+  await client.request(`/chat/session/${encodeURIComponent(sessionId)}`, {
+    method: "DELETE"
+  });
 }
 export {
-  DEFAULT_BASE_URL,
-  DEFAULT_HISTORY_TOP_UP_HBAR,
-  DEFAULT_PROGRESS_INTERVAL_MS,
-  DEFAULT_PROGRESS_TIMEOUT_MS,
-  DEFAULT_USER_AGENT,
-  JSON_CONTENT_TYPE,
-  MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS,
-  buildSearchQuery,
-  createAbortError,
-  isBrowserRuntime,
-  isJsonObject,
-  normaliseBaseUrl,
-  normaliseHeaderName,
-  normalizeHexPrivateKey,
-  serialiseAgentRegistrationRequest,
-  serialiseAuthConfig,
-  toJsonObject,
-  toJsonValue
+  acceptConversation,
+  compactHistory,
+  createChatApi,
+  createPlaintextConversationHandle,
+  createSession,
+  endSession,
+  fetchEncryptionStatus,
+  postEncryptionHandshake,
+  sendMessage,
+  startChat,
+  startConversation
 };
 //# sourceMappingURL=standards-sdk.es160.js.map

package/dist/es/standards-sdk.es160.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es160.js","sources":["../../src/services/registry-broker/client/utils.ts"],"sourcesContent":["import type {\n  AgentAuthConfig,\n  AgentRegistrationRequest,\n  JsonObject,\n  JsonValue,\n  SearchParams,\n} from '../types';\n\nexport const DEFAULT_USER_AGENT = '@hol-org/rb-client';\nexport const DEFAULT_PROGRESS_INTERVAL_MS = 1_500;\nexport const DEFAULT_PROGRESS_TIMEOUT_MS = 5 * 60 * 1_000;\nexport const DEFAULT_BASE_URL = 'https://hol.org/registry/api/v1';\nexport const JSON_CONTENT_TYPE = /application\\/json/i;\nexport const DEFAULT_HISTORY_TOP_UP_HBAR = 0.25;\nexport const MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS = 1;\n\nconst stripTrailingSlashes = (value: string): string => {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return end === value.length ? value : value.slice(0, end);\n};\n\nexport const createAbortError = (): Error =>\n  typeof DOMException === 'function'\n    ? new DOMException('Aborted', 'AbortError')\n    : new Error('The operation was aborted');\n\nexport const normaliseHeaderName = (name: string): string =>\n  name.trim().toLowerCase();\n\nexport const isBrowserRuntime = (): boolean =>\n  typeof window !== 'undefined' && typeof window.fetch === 'function';\n\nexport const toJsonValue = (value: unknown): JsonValue => {\n  if (value === null) {\n    return null;\n  }\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n  if (\n    typeof value === 'string' ||\n    typeof value === 'number' ||\n    typeof value === 'boolean'\n  ) {\n    return value;\n  }\n  if (Array.isArray(value)) {\n    return value.map(item => (item === undefined ? null : toJsonValue(item)));\n  }\n  if (typeof value === 'object') {\n    const result: JsonObject = {};\n    Object.entries(value as Record<string, unknown>).forEach(\n      ([key, entryValue]) => {\n        if (entryValue !== undefined) {\n          result[key] = toJsonValue(entryValue);\n        }\n      },\n    );\n    return result;\n  }\n  throw new TypeError('Only JSON-compatible values are supported');\n};\n\nexport const isJsonObject = (value: JsonValue): value is JsonObject =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const toJsonObject = (value: unknown): JsonObject => {\n  const normalised = toJsonValue(value);\n  if (isJsonObject(normalised)) {\n    return normalised;\n  }\n  throw new TypeError('Expected JSON object value');\n};\n\nexport const serialiseAuthConfig = (auth: AgentAuthConfig): JsonObject => {\n  const authPayload: JsonObject = {};\n  if (auth.type) {\n    authPayload.type = auth.type;\n  }\n  if (auth.token) {\n    authPayload.token = auth.token;\n  }\n  if (auth.username) {\n    authPayload.username = auth.username;\n  }\n  if (auth.password) {\n    authPayload.password = auth.password;\n  }\n  if (auth.headerName) {\n    authPayload.headerName = auth.headerName;\n  }\n  if (auth.headerValue) {\n    authPayload.headerValue = auth.headerValue;\n  }\n  if (auth.headers) {\n    authPayload.headers = { ...auth.headers };\n  }\n  return authPayload;\n};\n\nexport const serialiseAgentRegistrationRequest = (\n  payload: AgentRegistrationRequest,\n): JsonObject => {\n  const body: JsonObject = {\n    profile: toJsonObject(payload.profile),\n  };\n  if (payload.endpoint !== undefined) {\n    body.endpoint = payload.endpoint;\n  }\n  if (payload.protocol !== undefined) {\n    body.protocol = payload.protocol;\n  }\n  if (payload.communicationProtocol !== undefined) {\n    body.communicationProtocol = payload.communicationProtocol;\n  }\n  if (payload.registry !== undefined) {\n    body.registry = payload.registry;\n  }\n  if (payload.additionalRegistries !== undefined) {\n    body.additionalRegistries = payload.additionalRegistries;\n  }\n  if (payload.metadata !== undefined) {\n    body.metadata = toJsonObject(payload.metadata);\n  }\n  return body;\n};\n\nexport type X402NetworkId = 'base' | 'base-sepolia';\n\nexport const normalizeHexPrivateKey = (value: string): `0x${string}` => {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    throw new Error('evmPrivateKey is required');\n  }\n  return trimmed.startsWith('0x')\n    ? (trimmed as `0x${string}`)\n    : (`0x${trimmed}` as `0x${string}`);\n};\n\nexport function normaliseBaseUrl(input?: string): string {\n  const trimmed = input?.trim();\n  let baseCandidate =\n    trimmed && trimmed.length > 0 ? trimmed : DEFAULT_BASE_URL;\n\n  try {\n    const url = new URL(stripTrailingSlashes(baseCandidate));\n    const hostname = url.hostname.toLowerCase();\n    const ensureRegistryPrefix = (): void => {\n      if (!url.pathname.startsWith('/registry')) {\n        url.pathname =\n          url.pathname === '/' ? '/registry' : `/registry${url.pathname}`;\n      }\n    };\n\n    if (hostname === 'hol.org') {\n      ensureRegistryPrefix();\n      baseCandidate = url.toString();\n    } else if (\n      hostname === 'registry.hashgraphonline.com' ||\n      hostname === 'hashgraphonline.com'\n    ) {\n      ensureRegistryPrefix();\n      url.hostname = 'hol.org';\n      baseCandidate = url.toString();\n    }\n  } catch {}\n\n  const withoutTrailing = stripTrailingSlashes(baseCandidate);\n  if (/\\/api\\/v\\d+$/i.test(withoutTrailing)) {\n    return withoutTrailing;\n  }\n  if (/\\/api$/i.test(withoutTrailing)) {\n    return `${withoutTrailing}/v1`;\n  }\n  return `${withoutTrailing}/api/v1`;\n}\n\nexport function buildSearchQuery(params: SearchParams): string {\n  const query = new URLSearchParams();\n  const appendList = (key: string, values?: string[]) => {\n    if (!values) {\n      return;\n    }\n    values.forEach(value => {\n      if (typeof value === 'string') {\n        const trimmed = value.trim();\n        if (trimmed.length > 0) {\n          query.append(key, trimmed);\n        }\n      }\n    });\n  };\n\n  if (params.q) {\n    const trimmed = params.q.trim();\n    if (trimmed.length > 0) {\n      query.set('q', trimmed);\n    }\n  }\n  if (typeof params.page === 'number') {\n    query.set('page', params.page.toString());\n  }\n  if (typeof params.limit === 'number') {\n    query.set('limit', params.limit.toString());\n  }\n  if (params.registry) {\n    const trimmed = params.registry.trim();\n    if (trimmed.length > 0) {\n      query.set('registry', trimmed);\n    }\n  }\n  appendList('registries', params.registries);\n  if (typeof params.minTrust === 'number') {\n    query.set('minTrust', params.minTrust.toString());\n  }\n  appendList('capabilities', params.capabilities);\n  appendList('protocols', params.protocols);\n  appendList('adapters', params.adapters);\n\n  if (params.metadata) {\n    Object.entries(params.metadata).forEach(([key, values]) => {\n      if (!key || !Array.isArray(values) || values.length === 0) {\n        return;\n      }\n      const trimmedKey = key.trim();\n      if (trimmedKey.length === 0) {\n        return;\n      }\n      values.forEach(value => {\n        if (value === undefined || value === null) {\n          return;\n        }\n        query.append(`metadata.${trimmedKey}`, String(value));\n      });\n    });\n  }\n\n  if (params.type) {\n    const trimmedType = params.type.trim();\n    if (trimmedType.length > 0 && trimmedType.toLowerCase() !== 'all') {\n      query.set('type', trimmedType);\n    }\n  }\n\n  if (params.verified === true) {\n    query.set('verified', 'true');\n  }\n\n  if (params.online === true) {\n    query.set('online', 'true');\n  }\n\n  if (params.sortBy) {\n    const trimmedSort = params.sortBy.trim();\n    if (trimmedSort.length > 0) {\n      query.set('sortBy', trimmedSort);\n    }\n  }\n\n  if (params.sortOrder) {\n    const lowered = params.sortOrder.toLowerCase();\n    if (lowered === 'asc' || lowered === 'desc') {\n      query.set('sortOrder', lowered);\n    }\n  }\n  const queryString = query.toString();\n  return queryString.length > 0 ? `?${queryString}` : '';\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es160.js","sources":["../../src/services/registry-broker/client/chat.ts"],"sourcesContent":["import type {\n  AcceptConversationOptions,\n  AcceptEncryptedChatSessionOptions,\n  AgentAuthConfig,\n  ChatConversationHandle,\n  DecryptedHistoryEntry,\n  ChatHistoryCompactionResponse,\n  ChatHistoryFetchOptions,\n  ChatHistorySnapshotWithDecryptedEntries,\n  CompactHistoryRequestPayload,\n  CreateSessionRequestPayload,\n  CreateSessionResponse,\n  EncryptionHandshakeRecord,\n  EncryptionHandshakeSubmissionPayload,\n  EncryptedChatSessionHandle,\n  JsonObject,\n  JsonValue,\n  SendMessageRequestPayload,\n  SendMessageResponse,\n  SessionEncryptionStatusResponse,\n  SessionEncryptionSummary,\n  StartChatOptions,\n  StartConversationOptions,\n  StartEncryptedChatSessionOptions,\n} from '../types';\nimport {\n  chatHistoryCompactionResponseSchema,\n  createSessionResponseSchema,\n  encryptionHandshakeResponseSchema,\n  sendMessageResponseSchema,\n  sessionEncryptionStatusResponseSchema,\n} from '../schemas';\nimport type { RegistryBrokerClient } from './base-client';\nimport { serialiseAuthConfig, toJsonObject } from './utils';\nimport {\n  EncryptedChatManager,\n  EncryptionUnavailableError,\n} from './encrypted-chat-manager';\n\nexport interface RegistryBrokerChatApi {\n  start: (options: StartChatOptions) => Promise<ChatConversationHandle>;\n  createSession: (\n    payload: CreateSessionRequestPayload,\n  ) => Promise<CreateSessionResponse>;\n  sendMessage: (\n    payload: SendMessageRequestPayload,\n  ) => Promise<SendMessageResponse>;\n  endSession: (sessionId: string) => Promise<void>;\n  getHistory: (\n    sessionId: string,\n    options?: ChatHistoryFetchOptions,\n  ) => Promise<ChatHistorySnapshotWithDecryptedEntries>;\n  compactHistory: (\n    payload: CompactHistoryRequestPayload,\n  ) => Promise<ChatHistoryCompactionResponse>;\n  getEncryptionStatus: (\n    sessionId: string,\n  ) => Promise<SessionEncryptionStatusResponse>;\n  submitEncryptionHandshake: (\n    sessionId: string,\n    payload: EncryptionHandshakeSubmissionPayload,\n  ) => Promise<EncryptionHandshakeRecord>;\n  createEncryptedSession: (\n    options: StartEncryptedChatSessionOptions,\n  ) => Promise<EncryptedChatSessionHandle>;\n  acceptEncryptedSession: (\n    options: AcceptEncryptedChatSessionOptions,\n  ) => Promise<EncryptedChatSessionHandle>;\n  startConversation: (\n    options: StartConversationOptions,\n  ) => Promise<ChatConversationHandle>;\n  acceptConversation: (\n    options: AcceptConversationOptions,\n  ) => Promise<ChatConversationHandle>;\n}\n\nexport function createChatApi(\n  client: RegistryBrokerClient,\n  encryptedManager: EncryptedChatManager,\n): RegistryBrokerChatApi {\n  return {\n    start: (options: StartChatOptions) => client.startChat(options),\n    createSession: (payload: CreateSessionRequestPayload) =>\n      client.createSession(payload),\n    sendMessage: (payload: SendMessageRequestPayload) =>\n      client.sendMessage(payload),\n    endSession: (sessionId: string) => client.endSession(sessionId),\n    getHistory: (sessionId: string, options?: ChatHistoryFetchOptions) =>\n      client.fetchHistorySnapshot(sessionId, options),\n    compactHistory: (payload: CompactHistoryRequestPayload) =>\n      client.compactHistory(payload),\n    getEncryptionStatus: (sessionId: string) =>\n      client.fetchEncryptionStatus(sessionId),\n    submitEncryptionHandshake: (\n      sessionId: string,\n      payload: EncryptionHandshakeSubmissionPayload,\n    ) => client.postEncryptionHandshake(sessionId, payload),\n    startConversation: (options: StartConversationOptions) =>\n      client.startConversation(options),\n    acceptConversation: (options: AcceptConversationOptions) =>\n      client.acceptConversation(options),\n    createEncryptedSession: (options: StartEncryptedChatSessionOptions) =>\n      encryptedManager.startSession(options),\n    acceptEncryptedSession: (options: AcceptEncryptedChatSessionOptions) =>\n      encryptedManager.acceptSession(options),\n  };\n}\n\nexport async function createSession(\n  client: RegistryBrokerClient,\n  payload: CreateSessionRequestPayload,\n  allowHistoryAutoTopUp = true,\n): Promise<CreateSessionResponse> {\n  const body: JsonObject = {};\n  if ('uaid' in payload && payload.uaid) {\n    body.uaid = payload.uaid;\n  }\n  if ('agentUrl' in payload && payload.agentUrl) {\n    body.agentUrl = payload.agentUrl;\n  }\n  if (payload.auth) {\n    body.auth = serialiseAuthConfig(payload.auth);\n  }\n  if (payload.historyTtlSeconds !== undefined) {\n    body.historyTtlSeconds = payload.historyTtlSeconds;\n  }\n  if (payload.encryptionRequested !== undefined) {\n    body.encryptionRequested = payload.encryptionRequested;\n  }\n  if (payload.senderUaid) {\n    body.senderUaid = payload.senderUaid;\n  }\n  try {\n    const raw = await client.requestJson<JsonValue>('/chat/session', {\n      method: 'POST',\n      body,\n      headers: { 'content-type': 'application/json' },\n    });\n    return client.parseWithSchema(\n      raw,\n      createSessionResponseSchema,\n      'chat session response',\n    );\n  } catch (error) {\n    const maybeError = error instanceof Error ? error : null;\n    if (\n      allowHistoryAutoTopUp &&\n      client.shouldAutoTopUpHistory(payload, maybeError)\n    ) {\n      await client.executeHistoryAutoTopUp('chat.session');\n      return createSession(client, payload, false);\n    }\n    throw error;\n  }\n}\n\nexport async function startChat(\n  client: RegistryBrokerClient,\n  encryptedManager: EncryptedChatManager,\n  options: StartChatOptions,\n): Promise<ChatConversationHandle> {\n  if ('uaid' in options && options.uaid) {\n    return startConversation(client, encryptedManager, {\n      uaid: options.uaid,\n      senderUaid: options.senderUaid,\n      historyTtlSeconds: options.historyTtlSeconds,\n      auth: options.auth,\n      encryption: options.encryption,\n      onSessionCreated: options.onSessionCreated,\n    });\n  }\n  if ('agentUrl' in options && options.agentUrl) {\n    const session = await createSession(client, {\n      agentUrl: options.agentUrl,\n      auth: options.auth,\n      historyTtlSeconds: options.historyTtlSeconds,\n      senderUaid: options.senderUaid,\n    });\n    options.onSessionCreated?.(session.sessionId);\n    return createPlaintextConversationHandle(\n      client,\n      session.sessionId,\n      session.encryption ?? null,\n      options.auth,\n      { agentUrl: options.agentUrl, uaid: options.uaid },\n    );\n  }\n  throw new Error('startChat requires either uaid or agentUrl');\n}\n\nexport async function startConversation(\n  client: RegistryBrokerClient,\n  encryptedManager: EncryptedChatManager,\n  options: StartConversationOptions,\n): Promise<ChatConversationHandle> {\n  const preference = options.encryption?.preference ?? 'preferred';\n  const requestEncryption = preference !== 'disabled';\n  if (!requestEncryption) {\n    const session = await createSession(client, {\n      uaid: options.uaid,\n      auth: options.auth,\n      historyTtlSeconds: options.historyTtlSeconds,\n      senderUaid: options.senderUaid,\n      encryptionRequested: false,\n    });\n    options.onSessionCreated?.(session.sessionId);\n    return createPlaintextConversationHandle(\n      client,\n      session.sessionId,\n      session.encryption ?? null,\n      options.auth,\n      { uaid: options.uaid },\n    );\n  }\n  try {\n    const handle = await encryptedManager.startSession({\n      uaid: options.uaid,\n      senderUaid: options.senderUaid,\n      historyTtlSeconds: options.historyTtlSeconds,\n      handshakeTimeoutMs: options.encryption?.handshakeTimeoutMs,\n      pollIntervalMs: options.encryption?.pollIntervalMs,\n      onSessionCreated: sessionId => {\n        options.onSessionCreated?.(sessionId);\n      },\n      auth: options.auth,\n    });\n    return handle;\n  } catch (error) {\n    if (error instanceof EncryptionUnavailableError) {\n      if (preference === 'required') {\n        throw error;\n      }\n      return createPlaintextConversationHandle(\n        client,\n        error.sessionId,\n        error.summary ?? null,\n        options.auth,\n        { uaid: options.uaid },\n      );\n    }\n    throw error;\n  }\n}\n\nexport async function acceptConversation(\n  client: RegistryBrokerClient,\n  encryptedManager: EncryptedChatManager,\n  options: AcceptConversationOptions,\n): Promise<ChatConversationHandle> {\n  const preference = options.encryption?.preference ?? 'preferred';\n  if (preference === 'disabled') {\n    return createPlaintextConversationHandle(client, options.sessionId, null);\n  }\n  try {\n    const handle = await encryptedManager.acceptSession({\n      sessionId: options.sessionId,\n      responderUaid: options.responderUaid,\n      handshakeTimeoutMs: options.encryption?.handshakeTimeoutMs,\n      pollIntervalMs: options.encryption?.pollIntervalMs,\n    });\n    return handle;\n  } catch (error) {\n    if (\n      error instanceof EncryptionUnavailableError &&\n      preference !== 'required'\n    ) {\n      return createPlaintextConversationHandle(\n        client,\n        options.sessionId,\n        null,\n        undefined,\n        { uaid: options.responderUaid },\n      );\n    }\n    throw error;\n  }\n}\n\nexport function createPlaintextConversationHandle(\n  client: RegistryBrokerClient,\n  sessionId: string,\n  summary: SessionEncryptionSummary | null,\n  defaultAuth?: AgentAuthConfig,\n  context?: { uaid?: string; agentUrl?: string },\n): ChatConversationHandle {\n  const uaid = context?.uaid?.trim();\n  const agentUrl = context?.agentUrl?.trim();\n  const fetchHistory = async (\n    options?: ChatHistoryFetchOptions,\n  ): Promise<DecryptedHistoryEntry[]> => {\n    const snapshot = await client.fetchHistorySnapshot(sessionId, options);\n    if (snapshot.decryptedHistory) {\n      return snapshot.decryptedHistory;\n    }\n    return snapshot.history.map(entry => ({\n      entry,\n      plaintext: entry.content,\n    }));\n  };\n  return {\n    sessionId,\n    mode: 'plaintext',\n    summary: summary ?? null,\n    send: async options => {\n      const plaintext = options.plaintext;\n      if (!plaintext || plaintext.trim().length === 0) {\n        throw new Error('plaintext is required for chat messages');\n      }\n      const message = options.message ?? plaintext;\n      return sendMessage(client, {\n        sessionId,\n        message,\n        streaming: options.streaming,\n        auth: options.auth ?? defaultAuth,\n        uaid,\n        agentUrl,\n      });\n    },\n    decryptHistoryEntry: entry => entry.content,\n    fetchHistory,\n  };\n}\n\nexport async function compactHistory(\n  client: RegistryBrokerClient,\n  payload: CompactHistoryRequestPayload,\n): Promise<ChatHistoryCompactionResponse> {\n  if (!payload.sessionId || payload.sessionId.trim().length === 0) {\n    throw new Error('sessionId is required to compact chat history');\n  }\n  const body: JsonObject = {};\n  if (\n    typeof payload.preserveEntries === 'number' &&\n    Number.isFinite(payload.preserveEntries) &&\n    payload.preserveEntries >= 0\n  ) {\n    body.preserveEntries = Math.floor(payload.preserveEntries);\n  }\n  const raw = await client.requestJson<JsonValue>(\n    `/chat/session/${encodeURIComponent(payload.sessionId)}/compact`,\n    {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body,\n    },\n  );\n  return client.parseWithSchema(\n    raw,\n    chatHistoryCompactionResponseSchema,\n    'chat history compaction response',\n  );\n}\n\nexport async function fetchEncryptionStatus(\n  client: RegistryBrokerClient,\n  sessionId: string,\n): Promise<SessionEncryptionStatusResponse> {\n  if (!sessionId || sessionId.trim().length === 0) {\n    throw new Error('sessionId is required for encryption status');\n  }\n  const raw = await client.requestJson<JsonValue>(\n    `/chat/session/${encodeURIComponent(sessionId)}/encryption`,\n    {\n      method: 'GET',\n    },\n  );\n  return client.parseWithSchema(\n    raw,\n    sessionEncryptionStatusResponseSchema,\n    'session encryption status response',\n  );\n}\n\nexport async function postEncryptionHandshake(\n  client: RegistryBrokerClient,\n  sessionId: string,\n  payload: EncryptionHandshakeSubmissionPayload,\n): Promise<EncryptionHandshakeRecord> {\n  if (!sessionId || sessionId.trim().length === 0) {\n    throw new Error('sessionId is required for encryption handshake');\n  }\n  const raw = await client.requestJson<JsonValue>(\n    `/chat/session/${encodeURIComponent(sessionId)}/encryption-handshake`,\n    {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: {\n        role: payload.role,\n        keyType: payload.keyType,\n        ephemeralPublicKey: payload.ephemeralPublicKey,\n        longTermPublicKey: payload.longTermPublicKey,\n        signature: payload.signature,\n        uaid: payload.uaid,\n        userId: payload.userId,\n        ledgerAccountId: payload.ledgerAccountId,\n        metadata: payload.metadata,\n      },\n    },\n  );\n  const response = client.parseWithSchema(\n    raw,\n    encryptionHandshakeResponseSchema,\n    'encryption handshake response',\n  );\n  return response.handshake;\n}\n\nexport async function sendMessage(\n  client: RegistryBrokerClient,\n  payload: SendMessageRequestPayload,\n): Promise<SendMessageResponse> {\n  const body: JsonObject = {\n    message: payload.message,\n  };\n  if (payload.streaming !== undefined) {\n    body.streaming = payload.streaming;\n  }\n  if (payload.auth) {\n    body.auth = serialiseAuthConfig(payload.auth);\n  }\n  if ('uaid' in payload) {\n    body.uaid = payload.uaid;\n  }\n  if ('sessionId' in payload && payload.sessionId) {\n    body.sessionId = payload.sessionId;\n  }\n  if ('agentUrl' in payload && payload.agentUrl) {\n    body.agentUrl = payload.agentUrl;\n  }\n  let cipherEnvelope = payload.cipherEnvelope ?? null;\n  if (payload.encryption) {\n    const sessionIdForEncryption =\n      payload.encryption.sessionId ??\n      (typeof body.sessionId === 'string' ? body.sessionId : undefined);\n    if (!sessionIdForEncryption) {\n      throw new Error(\n        'sessionId is required when using encrypted chat payloads',\n      );\n    }\n    if (!payload.encryption.recipients?.length) {\n      throw new Error('recipients are required for encrypted chat payloads');\n    }\n    cipherEnvelope = client.encryption.encryptCipherEnvelope({\n      ...payload.encryption,\n      sessionId: sessionIdForEncryption,\n    });\n  }\n  if (cipherEnvelope) {\n    body.cipherEnvelope = toJsonObject(cipherEnvelope);\n  }\n  const raw = await client.requestJson<JsonValue>('/chat/message', {\n    method: 'POST',\n    body,\n    headers: { 'content-type': 'application/json' },\n  });\n  return client.parseWithSchema(\n    raw,\n    sendMessageResponseSchema,\n    'chat message response',\n  );\n}\n\nexport async function endSession(\n  client: RegistryBrokerClient,\n  sessionId: string,\n): Promise<void> {\n  await client.request(`/chat/session/${encodeURIComponent(sessionId)}`, {\n    method: 'DELETE',\n  });\n}\n"],"names":[],"mappings":"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"}

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

@@ -175,6 +175,20 @@ class EncryptedChatManager {
   createHandle(context) {
     const sharedSecret = context.sharedSecret;
     const uaid = context.summary.requester?.uaid ?? context.summary.responder?.uaid ?? context.identity?.uaid;
+    const decryptHistoryEntry = (entry) => this.decryptEntry(entry, context.identity, sharedSecret);
+    const fetchHistory = async (options) => {
+      const snapshot = await this.client.fetchHistorySnapshot(
+        context.sessionId,
+        options
+      );
+      if (snapshot.decryptedHistory) {
+        return snapshot.decryptedHistory;
+      }
+      return snapshot.history.map((entry) => ({
+        entry,
+        plaintext: decryptHistoryEntry(entry)
+      }));
+    };
     const handle = {
       sessionId: context.sessionId,
       mode: "encrypted",
@@ -194,7 +208,8 @@ class EncryptedChatManager {
           }
         });
       },
-      decryptHistoryEntry: (entry) => this.decryptEntry(entry, context.identity, sharedSecret)
+      decryptHistoryEntry,
+      fetchHistory
     };
     this.registerConversationContext({
       sessionId: context.sessionId,