@hashgraphonline/standards-sdk 0.1.181 → 0.1.183

package/dist/browser-root/standards-sdk.root-browser.js

@@ -6151,12 +6151,173 @@ const sessionEncryptionSummarySchema = objectType({
 });
 const chatHistoryEntrySchema = objectType({
   messageId: stringType(),
-  role: enumType(["user", "agent"]),
+  role: enumType([
+    "user",
+    "agent",
+    "system",
+    "tool",
+    "payment",
+    "delivery",
+    "error"
+  ]),
   content: stringType(),
   timestamp: stringType(),
   cipherEnvelope: cipherEnvelopeSchema.optional(),
   metadata: recordType(jsonValueSchema).optional()
 });
+const chatDeliveryStateSchema = enumType([
+  "draft",
+  "queued",
+  "persisted",
+  "delivered",
+  "streaming",
+  "responded",
+  "failed",
+  "timeout",
+  "cancelled"
+]);
+const chatAttachmentStateSchema = objectType({
+  supported: booleanType(),
+  status: enumType([
+    "unsupported",
+    "available",
+    "selected",
+    "uploading",
+    "scanning",
+    "ready",
+    "failed",
+    "rejected"
+  ]),
+  maxBytes: numberType().nullable().optional(),
+  acceptedMimeTypes: arrayType(stringType()).optional(),
+  reason: stringType().optional()
+});
+objectType({
+  messageId: stringType(),
+  kind: enumType([
+    "user",
+    "assistant",
+    "system",
+    "tool",
+    "payment",
+    "delivery",
+    "error"
+  ]),
+  content: stringType(),
+  timestamp: stringType(),
+  deliveryState: chatDeliveryStateSchema.optional(),
+  errorCode: stringType().optional(),
+  metadata: recordType(jsonValueSchema).optional(),
+  attachment: chatAttachmentStateSchema.optional()
+});
+const chatReadinessStatusSchema = enumType([
+  "responsive",
+  "delivery_only",
+  "degraded",
+  "blocked",
+  "unknown"
+]);
+const chatReplyModeSchema = enumType([
+  "direct",
+  "stream",
+  "poll",
+  "delivery_only",
+  "none"
+]);
+const chatRouteTypeSchema = enumType([
+  "a2a",
+  "hcs-10",
+  "mcp",
+  "openrouter",
+  "acp",
+  "xmtp",
+  "moltbook",
+  "agentverse",
+  "nanda",
+  "http",
+  "erc-8004",
+  "x402",
+  "unknown"
+]);
+const chatSessionStateSchema = enumType([
+  "connecting",
+  "ready",
+  "blocked",
+  "ended",
+  "expired"
+]);
+const chatErrorCodeSchema = enumType([
+  "AUTH_REQUIRED",
+  "CREDITS_REQUIRED",
+  "PAYMENT_REQUIRED",
+  "AGENT_UNRESPONSIVE",
+  "ROUTE_UNAVAILABLE",
+  "PROTOCOL_UNSUPPORTED",
+  "BROKER_NOT_EXECUTABLE",
+  "NETWORK_TIMEOUT",
+  "STREAM_STALLED",
+  "HISTORY_UNAVAILABLE",
+  "ENCRYPTION_REQUIRED",
+  "RATE_LIMITED",
+  "VALIDATION_ERROR",
+  "UNKNOWN_ERROR"
+]);
+const chatRouteSummarySchema = objectType({
+  type: chatRouteTypeSchema,
+  replyMode: chatReplyModeSchema,
+  transport: stringType(),
+  endpoint: stringType().optional()
+});
+const chatPaymentStateSchema = objectType({
+  required: booleanType(),
+  provider: enumType(["credits", "x402", "acp", "openrouter"]).optional(),
+  status: enumType([
+    "not_required",
+    "preflight",
+    "required",
+    "approved",
+    "paid",
+    "failed"
+  ]),
+  estimatedCredits: numberType().nullable().optional(),
+  estimatedUsd: numberType().nullable().optional()
+});
+const chatReadinessResponseSchema = objectType({
+  status: chatReadinessStatusSchema,
+  routeType: chatRouteTypeSchema,
+  replyMode: chatReplyModeSchema,
+  transport: stringType(),
+  endpoint: stringType().optional(),
+  checkedAt: stringType(),
+  cachedUntil: stringType(),
+  latencyMs: numberType().nullable().optional(),
+  lastSuccessfulReplyAt: stringType().nullable().optional(),
+  lastDeliveryConfirmationAt: stringType().nullable().optional(),
+  lastFailureCode: chatErrorCodeSchema.nullable().optional(),
+  supportsStreaming: booleanType(),
+  supportsHistory: booleanType(),
+  supportsEncryption: booleanType(),
+  supportsPayments: booleanType(),
+  supportsAttachments: booleanType(),
+  requiresAuth: booleanType(),
+  operatorActionRequired: booleanType(),
+  issue: objectType({
+    code: stringType(),
+    message: stringType(),
+    details: stringType().optional()
+  }).optional()
+});
+const chatSessionResumeResponseSchema = objectType({
+  sessionId: stringType(),
+  uaid: stringType().nullable().optional(),
+  agentUrl: stringType().nullable().optional(),
+  route: chatRouteSummarySchema,
+  transport: stringType(),
+  history: arrayType(chatHistoryEntrySchema),
+  historyTtlSeconds: numberType().optional(),
+  visibility: enumType(["private", "public"]).optional(),
+  state: chatSessionStateSchema
+});
 const metadataFacetSchema = recordType(
   unionType([
     arrayType(jsonValueSchema),
@@ -6356,7 +6517,16 @@ const createSessionResponseSchema = objectType({
   }),
   history: arrayType(chatHistoryEntrySchema).optional().default([]),
   historyTtlSeconds: numberType().nullable().optional(),
-  encryption: sessionEncryptionSummarySchema.nullable().optional()
+  encryption: sessionEncryptionSummarySchema.nullable().optional(),
+  route: chatRouteSummarySchema.optional(),
+  transport: stringType().optional(),
+  senderUaid: stringType().nullable().optional(),
+  visibility: enumType(["private", "public"]).optional(),
+  payment: chatPaymentStateSchema.optional(),
+  readiness: chatReadinessResponseSchema.optional(),
+  state: chatSessionStateSchema.optional(),
+  traceId: stringType().optional(),
+  expiresAt: stringType().nullable().optional()
 });
 const sendMessageResponseSchema = objectType({
   sessionId: stringType(),
@@ -6368,7 +6538,20 @@ const sendMessageResponseSchema = objectType({
   ops: arrayType(recordType(jsonValueSchema)).optional(),
   history: arrayType(chatHistoryEntrySchema).optional(),
   historyTtlSeconds: numberType().nullable().optional(),
-  encrypted: booleanType().optional()
+  encrypted: booleanType().optional(),
+  messageId: stringType().optional(),
+  assistantMessageId: stringType().nullable().optional(),
+  deliveryState: chatDeliveryStateSchema.optional(),
+  replyMode: chatReplyModeSchema.optional(),
+  deliveryConfirmation: booleanType().optional(),
+  idempotent: booleanType().optional(),
+  metadata: recordType(jsonValueSchema).optional(),
+  errorCode: chatErrorCodeSchema.optional()
+});
+const chatSessionEndResponseSchema = objectType({
+  message: stringType(),
+  sessionId: stringType(),
+  state: chatSessionStateSchema.optional()
 });
 const chatHistorySnapshotResponseSchema = objectType({
   sessionId: stringType(),
@@ -8833,8 +9016,12 @@ class EncryptedChatManager {
 function createChatApi(client, encryptedManager) {
   return {
     start: (options) => client.startChat(options),
+    readiness: (payload) => client.checkChatReadiness(payload),
     createSession: (payload) => client.createSession(payload),
+    resumeSession: (sessionId) => client.resumeSession(sessionId),
     sendMessage: (payload) => client.sendMessage(payload),
+    retryMessage: (messageId, payload) => client.retryMessage(messageId, payload),
+    cancelSession: (sessionId) => client.cancelSession(sessionId),
     endSession: (sessionId) => client.endSession(sessionId),
     getHistory: (sessionId, options) => client.fetchHistorySnapshot(sessionId, options),
     compactHistory: (payload) => client.compactHistory(payload),
@@ -8846,6 +9033,33 @@ function createChatApi(client, encryptedManager) {
     acceptEncryptedSession: (options) => encryptedManager.acceptSession(options)
   };
 }
+async function checkChatReadiness(client, payload) {
+  const body = {};
+  const uaid = "uaid" in payload ? payload.uaid?.trim() : void 0;
+  const agentUrl = "agentUrl" in payload ? payload.agentUrl?.trim() : void 0;
+  if (!uaid && !agentUrl) {
+    throw new Error("uaid or agentUrl is required to check chat readiness");
+  }
+  if (uaid) {
+    body.uaid = uaid;
+  }
+  if (agentUrl) {
+    body.agentUrl = agentUrl;
+  }
+  if (payload.forceRefresh !== void 0) {
+    body.forceRefresh = payload.forceRefresh;
+  }
+  const raw = await client.requestJson("/chat/readiness", {
+    method: "POST",
+    body,
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    chatReadinessResponseSchema,
+    "chat readiness response"
+  );
+}
 async function createSession(client, payload, allowHistoryAutoTopUp = true) {
   const body = {};
   if ("uaid" in payload && payload.uaid) {
@@ -8866,6 +9080,12 @@ async function createSession(client, payload, allowHistoryAutoTopUp = true) {
   if (payload.senderUaid) {
     body.senderUaid = payload.senderUaid;
   }
+  if (payload.visibility) {
+    body.visibility = payload.visibility;
+  }
+  if (payload.idempotencyKey) {
+    body.idempotencyKey = payload.idempotencyKey;
+  }
   try {
     const raw = await client.requestJson("/chat/session", {
       method: "POST",
@@ -8886,6 +9106,21 @@ async function createSession(client, payload, allowHistoryAutoTopUp = true) {
     throw error;
   }
 }
+async function resumeSession(client, sessionId) {
+  const normalized = sessionId.trim();
+  if (!normalized) {
+    throw new Error("sessionId is required to resume a chat session");
+  }
+  const raw = await client.requestJson(
+    `/chat/session/${encodeURIComponent(normalized)}/resume`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    chatSessionResumeResponseSchema,
+    "chat session resume response"
+  );
+}
 async function startChat(client, encryptedManager, options) {
   if ("uaid" in options && options.uaid) {
     return startConversation(client, encryptedManager, {
@@ -9100,6 +9335,15 @@ async function sendMessage(client, payload) {
   if (payload.streaming !== void 0) {
     body.streaming = payload.streaming;
   }
+  if (payload.idempotencyKey) {
+    body.idempotencyKey = payload.idempotencyKey;
+  }
+  if (payload.senderUaid) {
+    body.senderUaid = payload.senderUaid;
+  }
+  if (payload.transport) {
+    body.transport = payload.transport;
+  }
   if (payload.auth) {
     body.auth = serialiseAuthConfig(payload.auth);
   }
@@ -9143,9 +9387,130 @@ async function sendMessage(client, payload) {
   );
 }
 async function endSession(client, sessionId) {
-  await client.request(`/chat/session/${encodeURIComponent(sessionId)}`, {
-    method: "DELETE"
-  });
+  const normalizedSessionId = sessionId?.trim();
+  if (!normalizedSessionId) {
+    throw new Error("sessionId is required to end a chat session");
+  }
+  const response = await client.request(
+    `/chat/session/${encodeURIComponent(normalizedSessionId)}`,
+    { method: "DELETE" }
+  );
+  if (response.status === 204) {
+    return {
+      message: "Session ended",
+      sessionId: normalizedSessionId,
+      state: "ended"
+    };
+  }
+  const contentType = response.headers?.get("content-type") ?? "";
+  if (!contentType.toLowerCase().includes("json")) {
+    await response.text();
+    return {
+      message: "Session ended",
+      sessionId: normalizedSessionId,
+      state: "ended"
+    };
+  }
+  const responseBody = await response.text();
+  if (responseBody.trim().length === 0) {
+    return {
+      message: "Session ended",
+      sessionId: normalizedSessionId,
+      state: "ended"
+    };
+  }
+  const raw = JSON.parse(responseBody);
+  return client.parseWithSchema(
+    raw,
+    chatSessionEndResponseSchema,
+    "chat session end response"
+  );
+}
+async function cancelSession(client, sessionId) {
+  const normalizedSessionId = sessionId?.trim();
+  if (!normalizedSessionId) {
+    throw new Error("sessionId is required to cancel a chat session");
+  }
+  const raw = await client.requestJson(
+    `/chat/session/${encodeURIComponent(normalizedSessionId)}/cancel`,
+    {
+      method: "POST"
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    chatSessionEndResponseSchema,
+    "chat session cancel response"
+  );
+}
+async function retryMessage(client, messageId, payload) {
+  const normalizedMessageId = messageId?.trim();
+  const normalizedSessionId = payload.sessionId?.trim();
+  const normalizedMessage = payload.message?.trim();
+  if (!normalizedMessageId) {
+    throw new Error("messageId is required to retry a message");
+  }
+  if (!normalizedSessionId) {
+    throw new Error("sessionId is required to retry a message");
+  }
+  if (!normalizedMessage) {
+    throw new Error("message is required to retry a message");
+  }
+  const body = {
+    sessionId: normalizedSessionId,
+    message: payload.message
+  };
+  if (payload.streaming !== void 0) {
+    body.streaming = payload.streaming;
+  }
+  if (payload.transport) {
+    body.transport = payload.transport;
+  }
+  const uaid = payload.uaid?.trim();
+  const agentUrl = payload.agentUrl?.trim();
+  const idempotencyKey = payload.idempotencyKey?.trim();
+  const senderUaid = payload.senderUaid?.trim();
+  if (uaid) {
+    body.uaid = uaid;
+  }
+  if (agentUrl) {
+    body.agentUrl = agentUrl;
+  }
+  if (idempotencyKey) {
+    body.idempotencyKey = idempotencyKey;
+  }
+  if (senderUaid) {
+    body.senderUaid = senderUaid;
+  }
+  if (payload.auth) {
+    body.auth = serialiseAuthConfig(payload.auth);
+  }
+  let cipherEnvelope = payload.cipherEnvelope ?? null;
+  if (payload.encryption) {
+    if (!payload.encryption.recipients?.length) {
+      throw new Error("recipients are required for encrypted chat payloads");
+    }
+    cipherEnvelope = client.encryption.encryptCipherEnvelope({
+      ...payload.encryption,
+      sessionId: payload.encryption.sessionId ?? normalizedSessionId
+    });
+  }
+  if (cipherEnvelope) {
+    body.cipherEnvelope = toJsonObject(cipherEnvelope);
+  }
+  const raw = await client.requestJson(
+    `/chat/message/${encodeURIComponent(normalizedMessageId)}/retry`,
+    {
+      method: "POST",
+      body,
+      headers: { "content-type": "application/json" }
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    sendMessageResponseSchema,
+    "chat retry response"
+  );
 }
 const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
 let nodeRequire;
@@ -12797,6 +13162,12 @@ class RegistryBrokerClient {
   async createSession(payload, allowHistoryAutoTopUp = true) {
     return createSession(this, payload, allowHistoryAutoTopUp);
   }
+  async resumeSession(sessionId) {
+    return resumeSession(this, sessionId);
+  }
+  async checkChatReadiness(payload) {
+    return checkChatReadiness(this, payload);
+  }
   async startChat(options) {
     return startChat(this, this.getEncryptedChatManager(), options);
   }
@@ -12822,6 +13193,12 @@ class RegistryBrokerClient {
   sendMessage(payload) {
     return sendMessage(this, payload);
   }
+  retryMessage(messageId, payload) {
+    return retryMessage(this, messageId, payload);
+  }
+  cancelSession(sessionId) {
+    return cancelSession(this, sessionId);
+  }
   endSession(sessionId) {
     return endSession(this, sessionId);
   }