@soimy/dingtalk 3.6.1 → 3.6.2

package/dist/src/access-control.d.ts

@@ -0,0 +1,43 @@
+export type NormalizedAllowFrom = {
+    entries: string[];
+    entriesLower: string[];
+    hasWildcard: boolean;
+    hasEntries: boolean;
+};
+/**
+ * Normalize allowFrom list:
+ * - trim whitespace
+ * - support "dingtalk:/dd:/ding:" prefixes
+ * - precompute lower-case list for case-insensitive checks
+ */
+export declare function normalizeAllowFrom(list?: Array<string>): NormalizedAllowFrom;
+export declare function isSenderAllowed(params: {
+    allow: NormalizedAllowFrom;
+    senderId?: string;
+}): boolean;
+export declare function isSenderGroupAllowed(params: {
+    allow: NormalizedAllowFrom;
+    groupId?: string;
+}): boolean;
+export type GroupAccessResult = {
+    allowed: boolean;
+    reason?: "disabled" | "group_not_allowed" | "sender_not_allowed";
+    legacyFallback?: boolean;
+};
+export type GroupAccessParams = {
+    groupPolicy: "open" | "allowlist" | "disabled";
+    groupId: string;
+    senderId: string;
+    groups?: Record<string, {
+        groupAllowFrom?: string[];
+    }>;
+    groupAllowFrom?: string[];
+    allowFrom?: string[];
+};
+export declare function resolveGroupAccess(params: GroupAccessParams): GroupAccessResult;
+export declare function isSenderOwner(params: {
+    allow: NormalizedAllowFrom;
+    senderId?: string;
+    rawSenderId?: string;
+}): boolean;
+//# sourceMappingURL=access-control.d.ts.map

package/dist/src/access-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-control.d.ts","sourceRoot":"","sources":["../../src/access-control.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAa5E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAYV;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAMV;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACvD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAgD/E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAYV"}

package/dist/src/ack-reaction/dynamic-ack-reaction-controller.d.ts

@@ -0,0 +1,22 @@
+import type { DingTalkConfig } from "../types";
+import { type DynamicAckReactionLogger, type RuntimeEventsSurface } from "./dynamic-ack-reaction-events";
+type DynamicAckReactionControllerParams = {
+    enabled: boolean;
+    initialReaction: string;
+    initialAttached: boolean;
+    initialAttachedAt: number;
+    dingtalkConfig: DingTalkConfig;
+    msgId: string;
+    conversationId: string;
+    sessionKey: string;
+    log?: DynamicAckReactionLogger;
+    runtimeEvents?: RuntimeEventsSurface;
+    onReactionDisposed?: () => void;
+};
+export declare function createDynamicAckReactionController(params: DynamicAckReactionControllerParams): {
+    awaitDrain(): Promise<void>;
+    dispose(minVisibleMs: number): Promise<void>;
+    stop: () => void;
+};
+export {};
+//# sourceMappingURL=dynamic-ack-reaction-controller.d.ts.map

package/dist/src/ack-reaction/dynamic-ack-reaction-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-ack-reaction-controller.d.ts","sourceRoot":"","sources":["../../../src/ack-reaction/dynamic-ack-reaction-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAGL,KAAK,wBAAwB,EAE7B,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AAGvC,KAAK,kCAAkC,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,wBAAwB,CAAC;IAC/B,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAQF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,kCAAkC;kBA2MrE,OAAO,CAAC,IAAI,CAAC;0BAGL,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAhBnC,IAAI;EAgDtB"}

package/dist/src/ack-reaction/dynamic-ack-reaction-events.d.ts

@@ -0,0 +1,36 @@
+export type DynamicAckReactionLogger = {
+    debug?: (msg: string) => void;
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+};
+export type RuntimeAgentEvent = {
+    stream?: string;
+    runId?: string;
+    sessionKey?: string;
+    data?: {
+        phase?: string;
+        name?: string;
+        args?: unknown;
+        runId?: string;
+        sessionKey?: string;
+        toolCallId?: string;
+        meta?: {
+            runId?: string;
+            sessionKey?: string;
+        } | null;
+    };
+};
+export type RuntimeEventsSurface = {
+    onAgentEvent?: (listener: (event: unknown) => void) => (() => void);
+};
+export declare function getEventRunId(event: RuntimeAgentEvent | undefined): string | undefined;
+export declare function getEventSessionKey(event: RuntimeAgentEvent | undefined): string | undefined;
+export declare function describeEvent(event: RuntimeAgentEvent | undefined): string;
+export declare function createDynamicAckReactionCorrelator(params: {
+    sessionKey: string;
+    enabled: boolean;
+    createdAt: number;
+    optimisticCaptureWindowMs: number;
+    log?: DynamicAckReactionLogger;
+}): (event: RuntimeAgentEvent | undefined) => boolean;
+//# sourceMappingURL=dynamic-ack-reaction-events.d.ts.map

package/dist/src/ack-reaction/dynamic-ack-reaction-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-ack-reaction-events.d.ts","sourceRoot":"","sources":["../../../src/ack-reaction/dynamic-ack-reaction-events.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YACL,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,GAAG,IAAI,CAAC;KACV,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;CACrE,CAAC;AAWF,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE3F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAO1E;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,EAAE,MAAM,CAAC;IAClC,GAAG,CAAC,EAAE,wBAAwB,CAAC;CAChC,IAKS,OAAO,iBAAiB,GAAG,SAAS,KAAG,OAAO,CAuDvD"}

package/dist/src/ack-reaction/dynamic-ack-reaction-progress.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tool names here come from the runtime `onAgentEvent` tool-start payload.
+ * The runtime does not expose a typed enum on this event surface yet,
+ * so this mapping is intentionally best-effort and keeps a safe default.
+ */
+export declare function resolveToolProgressReaction(toolName: unknown, args: unknown): string;
+//# sourceMappingURL=dynamic-ack-reaction-progress.d.ts.map

package/dist/src/ack-reaction/dynamic-ack-reaction-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-ack-reaction-progress.d.ts","sourceRoot":"","sources":["../../../src/ack-reaction/dynamic-ack-reaction-progress.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuCpF"}

package/dist/src/ack-reaction-classifier.d.ts

@@ -0,0 +1,8 @@
+type SentenceType = "夸奖" | "责怪" | "命令" | "叙事" | "请求" | "未知";
+type AckReactionClassifyResult = {
+    type: SentenceType;
+    emoji: string;
+};
+export declare function classifyAckReactionEmoji(sentence: unknown): AckReactionClassifyResult;
+export {};
+//# sourceMappingURL=ack-reaction-classifier.d.ts.map

package/dist/src/ack-reaction-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack-reaction-classifier.d.ts","sourceRoot":"","sources":["../../src/ack-reaction-classifier.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D,KAAK,yBAAyB,GAAG;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAyCF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,yBAAyB,CA4BrF"}

package/dist/src/ack-reaction-service.d.ts

@@ -0,0 +1,15 @@
+import type { DingTalkConfig } from "./types";
+type AckReactionLogger = {
+    debug?: (msg: string) => void;
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+};
+type AckReactionTarget = {
+    msgId: string;
+    conversationId: string;
+    reactionName?: string;
+};
+export declare function attachNativeAckReaction(config: DingTalkConfig, data: AckReactionTarget, log?: AckReactionLogger): Promise<boolean>;
+export declare function recallNativeAckReactionWithRetry(config: DingTalkConfig, data: AckReactionTarget, log?: AckReactionLogger): Promise<void>;
+export {};
+//# sourceMappingURL=ack-reaction-service.d.ts.map

package/dist/src/ack-reaction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack-reaction-service.d.ts","sourceRoot":"","sources":["../../src/ack-reaction-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAc9C,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAoGF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,iBAAiB,EACvB,GAAG,CAAC,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAiClB;AAmBD,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,iBAAiB,EACvB,GAAG,CAAC,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/src/auth.d.ts

@@ -0,0 +1,7 @@
+import type { DingTalkConfig, Logger } from "./types";
+/**
+ * Get DingTalk access token with clientId-scoped cache + retry.
+ * Refreshes token one minute before expiry to avoid near-expiry failures.
+ */
+export declare function getAccessToken(config: DingTalkConfig, log?: Logger): Promise<string>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAa,MAAM,SAAS,CAAC;AAWjE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC1F"}

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

@@ -0,0 +1,14 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { CardCallbackAnalysis } from "../card-callback-service";
+import type { DingTalkConfig, Logger } from "../types";
+export interface CardActionResult {
+    handled: boolean;
+}
+export declare function handleCardAction(params: {
+    analysis: CardCallbackAnalysis;
+    cfg: OpenClawConfig;
+    accountId: string;
+    config: DingTalkConfig;
+    log?: Logger;
+}): Promise<CardActionResult>;
+//# sourceMappingURL=card-action-handler.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/card/card-markdown-image-reroute.d.ts

@@ -0,0 +1,16 @@
+export type MarkdownImageUrlClassification = "public" | "local" | "unsupported";
+export interface MarkdownImageCandidate {
+    alt: string;
+    url: string;
+    raw: string;
+    classification: MarkdownImageUrlClassification;
+    start: number;
+    end: number;
+}
+export declare function classifyMarkdownImageUrl(url: string): MarkdownImageUrlClassification;
+export declare function buildImagePlaceholderText(input: {
+    alt: string;
+    url: string;
+}): string;
+export declare function extractMarkdownImageCandidates(text: string): MarkdownImageCandidate[];
+//# sourceMappingURL=card-markdown-image-reroute.d.ts.map

package/dist/src/card/card-markdown-image-reroute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-markdown-image-reroute.d.ts","sourceRoot":"","sources":["../../../src/card/card-markdown-image-reroute.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,8BAA8B,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAuCD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,8BAA8B,CAsBpF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAYrF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAmBrF"}

package/dist/src/card/card-run-registry.d.ts

@@ -0,0 +1,60 @@
+/**
+ * In-process card run registry for tracking active AI card runs.
+ *
+ * DEPLOYMENT CONSTRAINT: This registry uses a process-local Map. In multi-process
+ * deployments (cluster/PM2), stop callbacks may route to a different worker than
+ * the one that created the card run, causing resolveCardRun to return null and
+ * the stop button to silently fail. Ensure single-process deployment or sticky
+ * routing per card callback when using the stop button feature.
+ */
+import type { CardDraftController } from "../card-draft-controller";
+import type { AICardInstance } from "../types";
+export interface CardRunRecord {
+    outTrackId: string;
+    accountId: string;
+    sessionKey: string;
+    /** OpenClaw agent ID resolved from the inbound route. */
+    agentId: string;
+    /** DingTalk userId of the user who initiated this card run. */
+    ownerUserId?: string;
+    card?: AICardInstance;
+    controller?: CardDraftController;
+    stopRequestedAt?: number;
+    registeredAt: number;
+}
+export declare function registerCardRun(outTrackId: string, params: {
+    accountId: string;
+    sessionKey: string;
+    agentId: string;
+    ownerUserId?: string;
+    card?: AICardInstance;
+    /** Override registeredAt timestamp (useful for tests). */
+    registeredAt?: number;
+}): void;
+export declare function attachCardRunController(outTrackId: string, controller: CardDraftController): void;
+export declare function resolveCardRun(outTrackId: string): CardRunRecord | null;
+/**
+ * Find the most recently registered card run for a given account + conversation.
+ * Uses case-insensitive match of the conversationId within sessionKey.
+ *
+ * @param accountId - The DingTalk account ID
+ * @param conversationId - The target conversation ID (matches within sessionKey)
+ * @param options - Optional filtering criteria
+ * @param options.ownerUserId - If provided, only return runs owned by this user
+ */
+export declare function resolveCardRunByConversation(accountId: string, conversationId: string, options?: {
+    ownerUserId?: string;
+}): CardRunRecord | null;
+/**
+ * Find the most recently registered card run for a given account + owner.
+ * This is a fallback query when conversationId is unavailable (e.g., sessionKey=-).
+ *
+ * @param accountId - The DingTalk account ID
+ * @param ownerUserId - The DingTalk userId of the card owner
+ */
+export declare function resolveCardRunByOwner(accountId: string, ownerUserId: string): CardRunRecord | null;
+export declare function markCardRunStopRequested(outTrackId: string): void;
+export declare function isCardRunStopRequested(outTrackId: string): boolean;
+export declare function removeCardRun(outTrackId: string): void;
+export declare function clearCardRunRegistryForTest(): void;
+//# sourceMappingURL=card-run-registry.d.ts.map

package/dist/src/card/card-run-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-run-registry.d.ts","sourceRoot":"","sources":["../../../src/card/card-run-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AA+BD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,IAAI,CAeN;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAKjG;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,aAAa,GAAG,IAAI,CActB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,aAAa,GAAG,IAAI,CAUtB;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKjE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAMlD"}

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

@@ -0,0 +1,18 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { DingTalkConfig, Logger } from "../types";
+export interface StopCardRunResult {
+    ok: boolean;
+    status: string;
+    reason?: string;
+    /** Last streamed content before stop, so callback response can preserve it. */
+    lastContent?: string;
+}
+export declare function stopCardRun(params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    outTrackId: string;
+    config?: DingTalkConfig;
+    clickerUserId?: string;
+    log?: Logger;
+}): Promise<StopCardRunResult>;
+//# sourceMappingURL=card-stop-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"card-stop-handler.d.ts","sourceRoot":"","sources":["../../../src/card/card-stop-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6D7B"}

package/dist/src/card/card-streaming-mode.d.ts

@@ -0,0 +1,8 @@
+import type { DingTalkConfig } from "../types";
+export type CardStreamingMode = "off" | "answer" | "all";
+export declare function resolveCardStreamingMode(config: Pick<DingTalkConfig, "cardStreamingMode" | "cardRealTimeStream">): {
+    mode: CardStreamingMode;
+    usedDeprecatedCardRealTimeStream: boolean;
+};
+export declare function shouldWarnDeprecatedCardRealTimeStreamOnce(configKey: string): boolean;
+//# sourceMappingURL=card-streaming-mode.d.ts.map

package/dist/src/card/card-streaming-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-streaming-mode.d.ts","sourceRoot":"","sources":["../../../src/card/card-streaming-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;AAMzD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,GACvE;IACD,IAAI,EAAE,iBAAiB,CAAC;IACxB,gCAAgC,EAAE,OAAO,CAAC;CAC3C,CAQA;AAED,wBAAgB,0CAA0C,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMrF"}

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

@@ -0,0 +1,21 @@
+/** Card variable value that shows the stop button. */
+export declare const STOP_ACTION_VISIBLE = true;
+/** Card variable value that hides the stop button. */
+export declare const STOP_ACTION_HIDDEN = false;
+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 interface DingTalkCardTemplateContract {
+    templateId: string;
+    contentKey: string;
+    /** V2: key for the streaming markdown field (same as contentKey). */
+    streamingKey: string;
+    /** V2: key for the block-list loopArray variable. */
+    blockListKey: string;
+    /** V2: key for the plain-text copy content variable (String type for card copy action). */
+    copyContentKey: string;
+}
+/** Frozen singleton — no allocation on every call. */
+export declare const DINGTALK_CARD_TEMPLATE: Readonly<DingTalkCardTemplateContract>;
+//# sourceMappingURL=card-template.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/card/reasoning-answer-split.d.ts

@@ -0,0 +1,6 @@
+export interface CardReasoningAnswerSplit {
+    reasoningText?: string;
+    answerText?: string;
+}
+export declare function splitCardReasoningAnswerText(text?: string): CardReasoningAnswerSplit;
+//# sourceMappingURL=reasoning-answer-split.d.ts.map

package/dist/src/card/reasoning-answer-split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-answer-split.d.ts","sourceRoot":"","sources":["../../../src/card/reasoning-answer-split.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AA4ID,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAkBpF"}

package/dist/src/card/reasoning-block-assembler.d.ts

@@ -0,0 +1,7 @@
+export interface ReasoningBlockAssembler {
+    ingestSnapshot: (text: string | undefined) => string[];
+    flushPendingAtBoundary: () => string[];
+    reset: () => void;
+}
+export declare function createReasoningBlockAssembler(): ReasoningBlockAssembler;
+//# sourceMappingURL=reasoning-block-assembler.d.ts.map

package/dist/src/card/reasoning-block-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-block-assembler.d.ts","sourceRoot":"","sources":["../../../src/card/reasoning-block-assembler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,EAAE,CAAC;IACvD,sBAAsB,EAAE,MAAM,MAAM,EAAE,CAAC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAgHD,wBAAgB,6BAA6B,IAAI,uBAAuB,CAwCvE"}

package/dist/src/card/statusline-renderer.d.ts

@@ -0,0 +1,24 @@
+export declare function formatTokenCount(n: number): string;
+export declare function formatDuration(seconds: number): string;
+export interface StatusLineData {
+    model?: string;
+    effort?: string;
+    agent?: string;
+    taskTime?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheRead?: number;
+    dapi_usage?: number;
+}
+export interface StatusLineConfig {
+    cardStatusLine?: {
+        model?: boolean;
+        effort?: boolean;
+        agent?: boolean;
+        taskTime?: boolean;
+        tokens?: boolean;
+        dapiUsage?: boolean;
+    };
+}
+export declare function renderStatusLine(data: StatusLineData, config: StatusLineConfig): string;
+//# sourceMappingURL=statusline-renderer.d.ts.map

package/dist/src/card/statusline-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusline-renderer.d.ts","sourceRoot":"","sources":["../../../src/card/statusline-renderer.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAyCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAavF"}

package/dist/src/card-callback-service.d.ts

@@ -0,0 +1,23 @@
+export interface CardCallbackAnalysis {
+    summary: string;
+    actionId?: string;
+    feedbackTarget?: string;
+    feedbackAckText?: string;
+    userId?: string;
+    spaceId?: string;
+    processQueryKey?: string;
+    outTrackId?: string;
+    cardInstanceId?: string;
+}
+export declare function extractCardActionSummary(data: unknown): string;
+export declare function extractCardActionId(data: unknown): string | undefined;
+export declare function analyzeCardCallback(data: unknown): CardCallbackAnalysis;
+/**
+ * Update card variables via PUT /v1.0/card/instances.
+ * Echoes params back into cardParamMap so the template can use conditional
+ * rendering (e.g. hiding buttons when a param is set).
+ */
+export declare function updateCardVariables(outTrackId: string, params: Record<string, unknown>, token: string, config?: {
+    bypassProxyForSend?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=card-callback-service.d.ts.map

package/dist/src/card-callback-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-callback-service.d.ts","sourceRoot":"","sources":["../../src/card-callback-service.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA+BD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAmB9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwBrE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CA0EvE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/src/card-draft-controller.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Card draft controller for throttled AI Card streaming updates.
+ *
+ * The controller keeps a single rendered card timeline made of:
+ * - sealed process blocks (`thinking` / `tool`)
+ * - an optional live thinking block
+ * - accumulated answer turns rendered as JSON CardBlock[]
+ *
+ * It delegates throttling and single-flight transport guarantees to
+ * {@link createDraftStreamLoop}.
+ */
+import type { AICardInstance, Logger } from "./types";
+export interface CardDraftController {
+    updateAnswer: (text: string, options?: {
+        stream?: boolean;
+        renderBlocks?: boolean;
+    }) => Promise<void>;
+    updateReasoning: (text: string) => Promise<void>;
+    updateThinking: (text: string) => Promise<void>;
+    appendThinkingBlock: (text: string) => Promise<void>;
+    updateTool: (text: string) => Promise<void>;
+    appendTool: (text: string) => Promise<void>;
+    /** Append an image block (type=3) with an uploaded mediaId. */
+    appendImageBlock: (mediaId: string, text?: string) => Promise<void>;
+    appendToolBeforeCurrentAnswer: (text: string) => Promise<void>;
+    /** Drop the current answer draft while keeping sealed earlier turns intact. */
+    discardCurrentAnswer: () => void;
+    /** Signal that a new assistant turn has started (e.g. after a tool call). */
+    notifyNewAssistantTurn: (options?: {
+        discardActiveAnswer?: boolean;
+    }) => Promise<void>;
+    startAssistantTurn: () => Promise<void>;
+    /** Seal the active thinking entry (keep it in timeline) without removing it. */
+    sealActiveThinking: () => Promise<void>;
+    flush: () => Promise<void>;
+    waitForInFlight: () => Promise<void>;
+    stop: () => void;
+    isFailed: () => boolean;
+    /** Last content successfully sent to card. */
+    getLastContent: () => string;
+    /** Last answer-only content successfully sent to card. */
+    getLastAnswerContent: () => string;
+    /** Current answer-only content composed from all completed answer turns. */
+    getFinalAnswerContent: () => string;
+    /** Current rendered timeline as CardBlock[] JSON string for blockList parameter. */
+    getRenderedBlocks: (options?: {
+        fallbackAnswer?: string;
+        overrideAnswer?: string;
+        compactProcessAnswerSpacing?: boolean;
+    }) => string;
+    /** Current rendered timeline as pure markdown text for content parameter and fallback. */
+    getRenderedContent: (options?: {
+        fallbackAnswer?: string;
+        overrideAnswer?: string;
+        compactProcessAnswerSpacing?: boolean;
+    }) => string;
+    /** Stream answer text to content key for real-time display. Only available when realTimeStreamEnabled=true. */
+    streamContent?: (text: string) => Promise<void>;
+    /** Clear the streaming content key. Only available when realTimeStreamEnabled=true. */
+    clearStreamingContent?: () => Promise<void>;
+    /** Whether real-time streaming is enabled. */
+    isRealTimeStreamEnabled: () => boolean;
+}
+export declare function createCardDraftController(params: {
+    card: AICardInstance;
+    throttleMs?: number;
+    /** Legacy compatibility: verbose mode previously lowered the throttle. */
+    verboseMode?: boolean;
+    /** Enable real-time streaming to content key for answer display. */
+    realTimeStreamEnabled?: boolean;
+    /** Optional callback to get the current statusLine for piggy-backing on blockList updates. */
+    getStatusLine?: () => string | undefined;
+    log?: Logger;
+}): CardDraftController;
+//# sourceMappingURL=card-draft-controller.d.ts.map

package/dist/src/card-draft-controller.d.ts.map

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

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

@@ -0,0 +1,99 @@
+import type { AICardInstance, DingTalkConfig, DingTalkTrackingMetadata, Logger, QuotedRef } from "./types";
+export declare function hideCardStopButton(outTrackId: string, token: string, config?: {
+    bypassProxyForSend?: boolean;
+}, retries?: number): Promise<void>;
+export declare function isAICardDegraded(accountId: string): boolean;
+export declare function getAICardDegradeState(accountId: string): {
+    remainingMs: number;
+    reason: string;
+} | null;
+export declare function activateAICardDegrade(accountId: string, reason: string, config?: DingTalkConfig, log?: Logger): void;
+export declare function clearAICardDegrade(accountId: string, log?: Logger): void;
+export declare function incrementCardDapiCount(card: AICardInstance): number;
+interface CreateAICardOptions {
+    accountId?: string;
+    storePath?: string;
+    persistPending?: boolean;
+    contextConversationId?: string;
+    /** Quote content to display in card header (shown when non-empty) */
+    quoteContent?: string;
+    /** Initial statusLine string to show on the first createAndDeliver render. */
+    statusLine?: string;
+}
+export declare function isCardInTerminalState(state: string): boolean;
+export declare function formatContentForCard(content: string | undefined, type: "thinking" | "tool"): string;
+/**
+ * Send a proactive text message via card API (createAndDeliver + immediate finalize).
+ * Used in card mode to replace oToMessages/batchSend for single-chat users.
+ */
+export declare function sendProactiveCardText(config: DingTalkConfig, conversationId: string, content: string, log?: Logger): Promise<{
+    ok: boolean;
+    error?: string;
+} & DingTalkTrackingMetadata>;
+export declare function recoverPendingCardsForAccount(config: DingTalkConfig, accountId: string, storePath?: string, log?: Logger): Promise<number>;
+export declare function finalizeActiveCardsForAccount(config: DingTalkConfig, accountId: string, reason: string, storePath?: string, log?: Logger): Promise<number>;
+export declare function createAICard(config: DingTalkConfig, conversationId: string, log?: Logger, options?: CreateAICardOptions): Promise<AICardInstance | null>;
+/**
+ * Update statusLine via PUT /v1.0/card/instances API.
+ */
+export declare function updateAICardStatusLine(card: AICardInstance, statusLine: string, log?: Logger): Promise<void>;
+export declare function updateAICardBlockList(card: AICardInstance, blockListJson: string, log?: Logger, options?: {
+    statusLine?: string;
+}): Promise<void>;
+/**
+ * Stream answer text to content key for real-time display.
+ * Only used when cardRealTimeStream=true.
+ * Uses streaming API because content is a simple string type.
+ */
+export declare function streamAICardContent(card: AICardInstance, text: string, log?: Logger): Promise<void>;
+/**
+ * Clear the streaming content key.
+ * Called when transitioning from streaming to blockList commit.
+ */
+export declare function clearAICardStreamingContent(card: AICardInstance, log?: Logger): Promise<void>;
+/**
+ * Options for finalizing an AI Card via instances API.
+ * All variables are written in a single API call for V2 template compatibility.
+ */
+export interface FinalizeCardOptions {
+    /** CardBlock[] JSON string for blockList variable */
+    blockListJson: string;
+    /** Pure markdown answer text for copy action (content variable) */
+    content: string;
+    /** Optional quoted message preview text */
+    quoteContent?: string;
+    /** Optional statusLine string for card template */
+    statusLine?: string;
+    /** Optional quoted message reference for caching */
+    quotedRef?: QuotedRef;
+}
+/**
+ * Commit blocks and finalize card via single instances API call.
+ * V2 template requires finalize through instances API (not streaming API).
+ * Writes blockList, content, quoteContent, statusLine, and flowStatus in one call.
+ */
+export declare function commitAICardBlocks(card: AICardInstance, options: FinalizeCardOptions, log?: Logger): Promise<void>;
+export declare function streamAICard(card: AICardInstance, content: string, finished?: boolean, log?: Logger): Promise<void>;
+/**
+ * Finalize AI Card via streaming API.
+ *
+ * @deprecated For V2 template, use `commitAICardBlocks()` instead which finalizes
+ * via instances API (single call writes blockList, content, flowStatus=3).
+ * This function is kept for backward compatibility with V1 template and for
+ * card-stop-handler which uses streaming API for immediate stop acknowledgment.
+ */
+export declare function finishAICard(card: AICardInstance, content: string, log?: Logger, options?: {
+    quotedRef?: QuotedRef;
+}): Promise<void>;
+export declare function recallAICardMessage(card: AICardInstance, log?: Logger): Promise<boolean>;
+export declare function finishStoppedAICard(card: AICardInstance, content: string, log?: Logger): Promise<void>;
+export declare function finalizeStoppedAICard(card: AICardInstance, options: {
+    reason: string;
+    previousContent?: string;
+    previousBlockListJson?: string;
+}, log?: Logger): Promise<void>;
+export declare function cacheCardContent(accountId: string, conversationId: string, content: string, createdAt: number, storePath?: string): void;
+export declare function findCardContent(accountId: string, conversationId: string, repliedCreatedAt: number, storePath?: string): string | null;
+export declare function clearCardContentCacheForTest(): void;
+export {};
+//# sourceMappingURL=card-service.d.ts.map

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

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