@soimy/dingtalk 3.6.6 → 3.6.8

package/src/types.ts

@@ -462,6 +462,16 @@ export interface SubAgentOptions {
   commandText?: string;
 }
 
+/**
+ * A trusted route resolved by the plugin before recursive or synthetic inbound handling.
+ * It is runtime-only and must never be populated from DingTalk callback payload fields.
+ */
+export interface ResolvedDingTalkRoute {
+  agentId: string;
+  sessionKey: string;
+  mainSessionKey: string;
+}
+
 /**
  * Message handler parameters
  */
@@ -472,6 +482,16 @@ export interface HandleDingTalkMessageParams {
   sessionWebhook: string;
   log?: Logger;
   dingtalkConfig: DingTalkConfig;
+  /** Distinguishes real Stream messages from Ask User callback reinjection. */
+  inboundOrigin?: "stream" | "ask-user";
+  /**
+   * Explicitly enables handler-owned queueing for a real gateway Stream
+   * callback. Direct/synthetic callers must not be inferred from raw message
+   * shape, because they may already be inside another handler lifecycle.
+   */
+  inboundQueueEligible?: boolean;
+  /** Reuses an already-resolved trusted route for recursive or synthetic handling. */
+  routeOverride?: ResolvedDingTalkRoute;
   /**
    * When set, routes message to the specified sub-agent instead of main agent.
    * This enables reuse of the main message handling logic for sub-agents.
@@ -487,6 +507,22 @@ export interface HandleDingTalkMessageParams {
     mediaPaths?: string[];
     mediaTypes?: string[];
   };
+  /**
+   * A pre-created AI Card to reuse instead of creating a new one. Set by the
+   * inbound session-queue dispatcher when a message was queued behind an active
+   * run: the card was already created and is showing a "已排队" acknowledgement,
+   * so the handler streams the real reply INTO this same card (in-place update)
+   * rather than spawning a second card. When unset, the handler creates a fresh
+   * card as usual.
+   */
+  preCreatedCard?: AICardInstance;
+  /**
+   * Internal recursion guard for the authorized inbound session queue. The
+   * first handler pass performs access control and trusted route resolution;
+   * the queued continuation re-enters with this set so it can consume the
+   * pre-created card without queueing itself again.
+   */
+  inboundQueueHandled?: boolean;
 }
 
 /**