@soimy/dingtalk 3.6.4 → 3.6.5

package/dist/src/card/ask-user-question-context.d.ts

@@ -0,0 +1,17 @@
+import type { DingTalkConfig, DingTalkInboundMessage, HandleDingTalkMessageParams, Logger } from "../types";
+export type DingTalkQuestionContext = {
+    cfg: HandleDingTalkMessageParams["cfg"];
+    accountId: string;
+    data: DingTalkInboundMessage;
+    sessionWebhook: string;
+    log?: Logger;
+    dingtalkConfig: DingTalkConfig;
+    questionScopeKey?: string;
+    onQuestionCardSent?: (event: {
+        questionId: string;
+        outTrackId: string;
+    }) => void | Promise<void>;
+};
+export declare function withDingTalkQuestionContext<T>(context: DingTalkQuestionContext, fn: () => Promise<T>): Promise<T>;
+export declare function getDingTalkQuestionContext(): DingTalkQuestionContext | undefined;
+//# sourceMappingURL=ask-user-question-context.d.ts.map

package/dist/src/card/ask-user-question-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question-context.d.ts","sourceRoot":"","sources":["../../../src/card/ask-user-question-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,EACP,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClG,CAAC;AAIF,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,GAAG,SAAS,CAEhF"}

package/dist/src/card/ask-user-question.d.ts

@@ -0,0 +1,241 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { DingTalkConfig, Logger } from "../types";
+import { type DingTalkQuestionContext } from "./ask-user-question-context";
+type AskUserOption = {
+    label?: string;
+    value?: string;
+    description?: string;
+};
+type AskUserQuestion = {
+    question?: string;
+    header?: string;
+    options?: AskUserOption[];
+    multiSelect?: boolean;
+};
+type FormFieldType = "TEXT" | "TEXT_ARRAY" | "TEXT_AREA" | "NUMBER" | "SELECT" | "MULTI_SELECT" | "DATE" | "TIME" | "DATETIME" | "CHECKBOX" | "SWITCH" | "CHECKBOX_GROUP" | "MULTI_CHECKBOX_GROUP";
+type RawValue = string | number | boolean;
+type SelectValue = {
+    index: number;
+    value: RawValue;
+};
+type MultiSelectValue = {
+    index: number[];
+    value: RawValue[];
+};
+type FormField = {
+    name: string;
+    label?: string;
+    type: FormFieldType;
+    hidden?: boolean;
+    required?: boolean;
+    requiredMsg?: string;
+    readOnly?: boolean;
+    placeholder?: string;
+    format?: string;
+    defaultValue?: RawValue | RawValue[] | SelectValue | MultiSelectValue;
+    defautValue?: RawValue | RawValue[] | SelectValue | MultiSelectValue;
+    options?: Array<{
+        value: string;
+        text: string;
+    }>;
+    minRows?: number;
+    maxRows?: number;
+    addText?: string;
+};
+type PendingQuestion = DingTalkQuestionContext & {
+    questionId: string;
+    outTrackId: string;
+    title: string;
+    questions: Array<{
+        fieldName: string;
+        title: string;
+        options: Array<{
+            value: string;
+            text: string;
+        }>;
+        multiSelect: boolean;
+    }>;
+    submitted: boolean;
+    ownerUserId?: string;
+    ttlTimer?: ReturnType<typeof setTimeout>;
+};
+type ParsedCardCallback = {
+    outTrackId?: string;
+    actionId?: string;
+    params: Record<string, unknown>;
+    hasBusinessPayload: boolean;
+};
+export declare function buildQuestionForm(questions: AskUserQuestion[]): {
+    title: string;
+    desc: string;
+    fields: FormField[];
+    parsed: PendingQuestion["questions"];
+};
+export declare function buildQuestionFormFromFields(params: {
+    title?: string;
+    description?: string;
+    fields: FormField[];
+}): {
+    title: string;
+    desc: string;
+    fields: FormField[];
+    parsed: PendingQuestion["questions"];
+};
+export declare function parseAskUserCardCallback(payload: unknown): ParsedCardCallback;
+export declare function handleDingTalkAskUserCardCallback(params: {
+    payload: unknown;
+    cfg: DingTalkQuestionContext["cfg"];
+    accountId: string;
+    config: DingTalkConfig;
+    clickerUserId?: string;
+    log?: Logger;
+}): Promise<{
+    handled: boolean;
+}>;
+declare const AskUserQuestionSchema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly anyOf: readonly [{
+        readonly required: readonly ["questions"];
+    }, {
+        readonly required: readonly ["fields"];
+    }];
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly description: "Card title. Used with fields; omit to use the first field label.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "Short description shown above the form. Used with fields.";
+        };
+        readonly questions: {
+            readonly type: "array";
+            readonly description: string;
+            readonly minItems: 1;
+            readonly maxItems: 6;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["question", "header", "options"];
+                readonly properties: {
+                    readonly question: {
+                        readonly type: "string";
+                        readonly description: "The question to ask the user";
+                    };
+                    readonly header: {
+                        readonly type: "string";
+                        readonly description: "Short label for the question (max 12 chars)";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly maxItems: 20;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["label"];
+                            readonly properties: {
+                                readonly label: {
+                                    readonly type: "string";
+                                    readonly description: "Display text for this option";
+                                };
+                                readonly value: {
+                                    readonly type: "string";
+                                    readonly description: "Machine-readable value returned to the assistant; omit to use label";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                    readonly description: "Explanation of what this option means";
+                                };
+                            };
+                        };
+                        readonly description: string;
+                    };
+                    readonly multiSelect: {
+                        readonly type: "boolean";
+                        readonly description: "Whether multiple options can be selected (ignored when options is empty)";
+                    };
+                };
+            };
+        };
+        readonly fields: {
+            readonly type: "array";
+            readonly description: string;
+            readonly minItems: 1;
+            readonly maxItems: 20;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name", "label", "type"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly description: "Unique form field key";
+                    };
+                    readonly label: {
+                        readonly type: "string";
+                        readonly description: "Field label shown to the user";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["TEXT", "TEXT_ARRAY", "TEXT_AREA", "NUMBER", "SELECT", "MULTI_SELECT", "DATE", "TIME", "DATETIME", "CHECKBOX", "SWITCH", "CHECKBOX_GROUP", "MULTI_CHECKBOX_GROUP"];
+                        readonly description: "DingTalk form field type";
+                    };
+                    readonly hidden: {
+                        readonly type: "boolean";
+                    };
+                    readonly required: {
+                        readonly type: "boolean";
+                    };
+                    readonly requiredMsg: {
+                        readonly type: "string";
+                    };
+                    readonly readOnly: {
+                        readonly type: "boolean";
+                    };
+                    readonly placeholder: {
+                        readonly type: "string";
+                    };
+                    readonly defaultValue: {};
+                    readonly defautValue: {
+                        readonly description: "Compatibility alias for DingTalk form protocol documentation typo; prefer defaultValue when possible.";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly description: "Required for SELECT, MULTI_SELECT, CHECKBOX_GROUP, and MULTI_CHECKBOX_GROUP. Each option must be { value, text }.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["value", "text"];
+                            readonly properties: {
+                                readonly value: {
+                                    readonly type: "string";
+                                };
+                                readonly text: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                    readonly minRows: {
+                        readonly type: "number";
+                    };
+                    readonly maxRows: {
+                        readonly type: "number";
+                    };
+                    readonly addText: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+    };
+};
+export declare function getAskUserQuestionSchemaForTest(): typeof AskUserQuestionSchema;
+export declare function registerPendingQuestionForTest(ctx: Omit<PendingQuestion, "ttlTimer" | "submitted"> & {
+    submitted?: boolean;
+}): void;
+export declare function clearPendingQuestionsForTest(): void;
+export declare function registerDingTalkAskUserQuestionTool(api: OpenClawPluginApi): void;
+export {};
+//# sourceMappingURL=ask-user-question.d.ts.map

package/dist/src/card/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../../src/card/ask-user-question.ts"],"names":[],"mappings":"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"}

package/dist/src/card/card-action-handler.d.ts

@@ -5,6 +5,7 @@ export interface CardActionResult {
     handled: boolean;
 }
 export declare function handleCardAction(params: {
+    payload: unknown;
     analysis: CardCallbackAnalysis;
     cfg: OpenClawConfig;
     accountId: string;

package/dist/src/card/card-action-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-action-handler.d.ts","sourceRoot":"","sources":["../../../src/card/card-action-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6C5B"}
+{"version":3,"file":"card-action-handler.d.ts","sourceRoot":"","sources":["../../../src/card/card-action-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyD5B"}

package/dist/src/card/card-template.d.ts

@@ -6,6 +6,7 @@ export declare const BUILTIN_DINGTALK_CARD_TEMPLATE_ID: string;
 export declare const BUILTIN_DINGTALK_CARD_CONTENT_KEY = "content";
 export declare const BUILTIN_DINGTALK_CARD_BLOCK_LIST_KEY = "blockList";
 export declare const BUILTIN_DINGTALK_CARD_COPY_CONTENT_KEY = "copy_content";
+export declare const BUILTIN_DINGTALK_ASK_USER_CARD_TEMPLATE_ID = "89d0c6fe-3822-44c8-950e-e950f562546d.schema";
 export interface DingTalkCardTemplateContract {
     templateId: string;
     contentKey: string;
@@ -16,6 +17,10 @@ export interface DingTalkCardTemplateContract {
     /** V2: key for the plain-text copy content variable (String type for card copy action). */
     copyContentKey: string;
 }
+export interface DingTalkAskUserCardTemplateContract {
+    templateId: string;
+}
 /** Frozen singleton — no allocation on every call. */
 export declare const DINGTALK_CARD_TEMPLATE: Readonly<DingTalkCardTemplateContract>;
+export declare const DINGTALK_ASK_USER_CARD_TEMPLATE: Readonly<DingTalkAskUserCardTemplateContract>;
 //# sourceMappingURL=card-template.d.ts.map

package/dist/src/card/card-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-template.d.ts","sourceRoot":"","sources":["../../../src/card/card-template.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,eAAO,MAAM,iCAAiC,QAC0C,CAAC;AACzF,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAC3D,eAAO,MAAM,oCAAoC,cAAc,CAAC;AAChE,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,4BAA4B,CAMxE,CAAC"}
+{"version":3,"file":"card-template.d.ts","sourceRoot":"","sources":["../../../src/card/card-template.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,eAAO,MAAM,iCAAiC,QAC0C,CAAC;AACzF,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAC3D,eAAO,MAAM,oCAAoC,cAAc,CAAC;AAChE,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AACrE,eAAO,MAAM,0CAA0C,gDACR,CAAC;AAEhD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mCAAmC;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,4BAA4B,CAMxE,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,mCAAmC,CAGtF,CAAC"}

package/dist/src/gateway/channel-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-gateway.d.ts","sourceRoot":"","sources":["../../../src/gateway/channel-gateway.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAuFlB,eAAO,MAAM,iCAAiC,EAAG,aAAsB,CAAC;AAwCxE,wBAAgB,qBAAqB,IAAI,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAkerF"}
+{"version":3,"file":"channel-gateway.d.ts","sourceRoot":"","sources":["../../../src/gateway/channel-gateway.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAuFlB,eAAO,MAAM,iCAAiC,EAAG,aAAsB,CAAC;AAwCxE,wBAAgB,qBAAqB,IAAI,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAqerF"}

package/dist/src/inbound-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-handler.d.ts","sourceRoot":"","sources":["../../src/inbound-handler.ts"],"names":[],"mappings":"AAwEA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAU,SAAS,EAAE,MAAM,SAAS,CAAC;AAyQ9F,wBAAgB,wCAAwC,IAAI,IAAI,CAG/D;AA4FD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA0G3B;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAsqD9F"}
+{"version":3,"file":"inbound-handler.d.ts","sourceRoot":"","sources":["../../src/inbound-handler.ts"],"names":[],"mappings":"AAkFA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAU,SAAS,EAAE,MAAM,SAAS,CAAC;AAyQ9F,wBAAgB,wCAAwC,IAAI,IAAI,CAG/D;AA4FD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA0G3B;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}

package/index.ts

@@ -1,6 +1,7 @@
 import { defineChannelPluginEntry, type OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { readStringParam } from "openclaw/plugin-sdk/param-readers";
 import { getAccessToken } from "./src/auth";
+import { registerDingTalkAskUserQuestionTool } from "./src/card/ask-user-question";
 import { dingtalkPlugin } from "./src/channel";
 import { getConfig, listDingTalkAccountIds, resolveDingTalkAccount } from "./src/config";
 import {
@@ -279,7 +280,7 @@ function registerDingTalkConnectorCompatibilityGatewayMethods(api: OpenClawPlugi
 export { dingtalkPlugin } from "./src/channel";
 export { setDingTalkRuntime } from "./src/runtime";
 
-export default defineChannelPluginEntry({
+const dingtalkEntry = defineChannelPluginEntry({
   id: "dingtalk",
   name: "DingTalk Channel",
   description: "DingTalk (钉钉) messaging channel via Stream mode",
@@ -288,6 +289,7 @@ export default defineChannelPluginEntry({
   registerFull(api) {
     registerDingTalkDocsGatewayMethods(api);
     registerDingTalkConnectorCompatibilityGatewayMethods(api);
+    registerDingTalkAskUserQuestionTool(api);
 
     api.on(
       "llm_output",
@@ -308,3 +310,18 @@ export default defineChannelPluginEntry({
     );
   },
 });
+
+export default {
+  ...dingtalkEntry,
+  register(api: OpenClawPluginApi) {
+    const registrationMode = api.registrationMode as string | undefined;
+    if (registrationMode === "tool-discovery") {
+      registerDingTalkAskUserQuestionTool(api);
+      return;
+    }
+    if (registrationMode === "discovery") {
+      registerDingTalkAskUserQuestionTool(api);
+    }
+    dingtalkEntry.register(api);
+  },
+};

package/openclaw.plugin.json

@@ -1,6 +1,9 @@
 {
   "id": "dingtalk",
   "channels": ["dingtalk"],
+  "contracts": {
+    "tools": ["dingtalk_ask_user_question"]
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soimy/dingtalk",
-  "version": "3.6.4",
+  "version": "3.6.5",
   "description": "DingTalk (钉钉) channel plugin for OpenClaw",
   "keywords": [
     "bot",

package/src/card/ask-user-question-context.ts

@@ -0,0 +1,31 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type {
+  DingTalkConfig,
+  DingTalkInboundMessage,
+  HandleDingTalkMessageParams,
+  Logger,
+} from "../types";
+
+export type DingTalkQuestionContext = {
+  cfg: HandleDingTalkMessageParams["cfg"];
+  accountId: string;
+  data: DingTalkInboundMessage;
+  sessionWebhook: string;
+  log?: Logger;
+  dingtalkConfig: DingTalkConfig;
+  questionScopeKey?: string;
+  onQuestionCardSent?: (event: { questionId: string; outTrackId: string }) => void | Promise<void>;
+};
+
+const questionContextStorage = new AsyncLocalStorage<DingTalkQuestionContext>();
+
+export function withDingTalkQuestionContext<T>(
+  context: DingTalkQuestionContext,
+  fn: () => Promise<T>,
+): Promise<T> {
+  return questionContextStorage.run(context, fn);
+}
+
+export function getDingTalkQuestionContext(): DingTalkQuestionContext | undefined {
+  return questionContextStorage.getStore();
+}