@dudousxd/nestjs-agent 1.25.0 → 1.25.2

package/README.md

@@ -151,6 +151,12 @@ With nothing bound to `AGENT_ATTACHMENT_STAGING` there is no way to tell whose m
 turn carrying attachments is refused with `501`. Text-only turns are unaffected. At most 10
 attachments per turn.
 
+A send must carry something to answer: a non-blank `message`, an attachment, or `regenerate: true`.
+Anything else (`{}`, a blank message) is `400 { code: 'no_user_message' }` (`NO_USER_MESSAGE_CODE`)
+before any thread, run or queue entry exists, on `POST /agent/chat`, the AG-UI route and
+`AgentService.send` / `chat` alike; a `message` that is not a string is `400 invalid_message`. An
+attachment-only send runs with an empty text.
+
 `POST /agent/attachments` (multipart, live whenever a staging store is bound — `501` otherwise)
 aborts a body larger than `HARD_MAX_ATTACHMENT_BYTES` (32 MiB) while it streams; the configured
 `maxBytes` narrows that ceiling at request time and cannot raise it. The limits come from ONE place:

package/dist/durable/index.cjs

@@ -2545,6 +2545,30 @@ function _ts_param7(paramIndex, decorator) {
   };
 }
 __name(_ts_param7, "_ts_param");
+var NO_USER_MESSAGE_CODE = "no_user_message";
+function sendableParams(params) {
+  const message = params.message;
+  if (message !== void 0 && message !== null && typeof message !== "string") {
+    throw new import_common10.BadRequestException({
+      statusCode: 400,
+      code: "invalid_message",
+      message: "message must be a string"
+    });
+  }
+  const text = typeof message === "string" ? message : "";
+  if (text.trim().length === 0 && (params.attachments?.length ?? 0) === 0 && params.regenerate !== true) {
+    throw new import_common10.BadRequestException({
+      statusCode: 400,
+      code: NO_USER_MESSAGE_CODE,
+      message: "nothing to answer: send a non-empty message, an attachment, or regenerate"
+    });
+  }
+  return text === message ? params : {
+    ...params,
+    message: text
+  };
+}
+__name(sendableParams, "sendableParams");
 var AgentService = class {
   static {
     __name(this, "AgentService");
@@ -2813,7 +2837,8 @@ var AgentService = class {
   * Send a message: start a turn, or — when its thread already has one running — queue the message
   * to run after it (see {@link ChatSendMode}). What `POST <base>/chat` calls.
   */
-  async send(params, sendOptions = {}) {
+  async send(claimed, sendOptions = {}) {
+    const params = sendableParams(claimed);
     if (sendOptions.textDecisions !== false && this.options?.actionApprovalMode === "independent" && params.threadId !== void 0 && params.regenerate !== true && this.proposals) {
       const decision = await this.proposals.handleTextDecision(params.threadId, params.actor, params.message);
       if ("proposalDecision" in decision) return decision;