@qwen-code/channel-dws 0.22.2-preview.0

package/dist/dws-channel.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PollingChannelBase, type ChannelAgentBridge, type ChannelBaseOptions, type ChannelConfig, type ChannelTaskLifecycleEvent, type CreatePairingRequestResult, type Envelope } from '@qwen-code/channel-base';
+import { type DwsClientLike, type DwsImMessage, type DwsImTarget } from './dws-client.js';
+interface DwsConfig extends ChannelConfig {
+    profile?: unknown;
+    watchTodos?: unknown;
+}
+interface PersistedImTarget {
+    conversationId: string;
+    target: DwsImTarget;
+}
+interface PersistedTodoState {
+    taskId: string;
+    fingerprint: string;
+}
+interface PersistedNotificationCheckpoint {
+    startTime: number;
+    endTime: number;
+    cursor: string;
+}
+interface PersistedDocumentNotification {
+    documentId: string;
+    commentKey: string;
+    request: string;
+    messageId: string;
+    conversationId: string;
+    senderId: string;
+    senderName: string;
+    retryAttempts?: number;
+    nextRetryAt?: number;
+}
+interface PersistedPendingMessage {
+    source: {
+        kind: 'direct';
+    } | {
+        kind: 'group-all';
+    } | {
+        kind: 'group';
+        conversationId: string;
+    };
+    message: DwsImMessage;
+}
+interface DwsCursor {
+    version: 1;
+    selfProfile?: string;
+    selfSenderIds: string[];
+    documentIds?: string[];
+    notificationWatermark?: number;
+    mentionWatermark?: number;
+    notificationCheckpoint?: PersistedNotificationCheckpoint;
+    mentionCheckpoint?: PersistedNotificationCheckpoint;
+    pendingDocumentNotifications?: PersistedDocumentNotification[];
+    pendingMessages?: PersistedPendingMessage[];
+    processedMessages: string[];
+    imTargets: PersistedImTarget[];
+    todosInitialized?: boolean;
+    todoTasks?: PersistedTodoState[];
+    pairingNotifications?: string[];
+    inboundFailures?: PersistedInboundFailure[];
+}
+/**
+ * Per-message failure accounting for the inbound turn path.
+ *
+ * A message whose turn throws is never marked processed and never advances
+ * the watermark, so history polling re-fetched and re-ran it as a FULL agent
+ * turn every poll, forever — one model call per iteration, with no cap and no
+ * backoff, while the pinned watermark made the query window grow without
+ * bound and the throw starved every newer message behind it. Pending-document
+ * replay already had exactly this accounting; the failure-retry path had
+ * none.
+ */
+interface PersistedInboundFailure {
+    key: string;
+    attempts: number;
+}
+export declare class DwsChannel extends PollingChannelBase<DwsCursor> {
+    private readonly documentSet;
+    private readonly todoTargets;
+    private readonly userInstructions?;
+    private readonly client;
+    private readonly imStates;
+    private readonly watchTodos;
+    private readonly inboundReactionTargets;
+    private readonly activeReactionKeys;
+    private readonly sessionReactionKeys;
+    private readonly notifiedSenderPairingNotifications;
+    private readonly processingMessages;
+    private pollAbortController;
+    private lifecycleGeneration;
+    private connectionStartedAt;
+    private lastTodoPollAt;
+    private connected;
+    private notificationWatermarkPulledBack;
+    constructor(name: string, config: DwsConfig & Record<string, unknown>, bridge: ChannelAgentBridge, options?: ChannelBaseOptions, client?: DwsClientLike);
+    protected createInitialCursor(): DwsCursor;
+    protected validateCursor(parsed: unknown): DwsCursor | null;
+    connect(): Promise<void>;
+    private rememberDocumentId;
+    disconnect(): void;
+    supportsProactiveSend(): boolean;
+    protected get pollInterval(): number;
+    protected get todoPollInterval(): number;
+    protected preflightInbound(envelope: Envelope): boolean | Promise<boolean>;
+    protected onPairingRequired(chatId: string, result: CreatePairingRequestResult, threadId?: string, senderId?: string): Promise<void>;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    private sendImText;
+    protected sendThreadMessage(chatId: string, threadId: string | undefined, text: string): Promise<void>;
+    protected sendResponseMessage(chatId: string, text: string, sessionId: string): Promise<void>;
+    protected pollOnce(): Promise<void>;
+    private pollTodos;
+    private processTodoTask;
+    private rememberTodoState;
+    private rememberPairingNotification;
+    private clearPairingNotifications;
+    private startImSource;
+    private startImSourceWithRetry;
+    private waitForImRetry;
+    private scheduleImRestart;
+    private logImError;
+    private handleImMessage;
+    private processImMessage;
+    /**
+     * Account one failed inbound turn, and drop the message once its budget is
+     * spent.
+     *
+     * Returns whether the caller should rethrow. Under budget it should — the
+     * throw is what drives redelivery retry, and existing contracts depend on
+     * it. Once the budget is spent the message is marked processed and the
+     * error is swallowed: the throw used to abort the caller's sorted loop, so
+     * one poison message starved every newer message behind it and never
+     * cleared, because nothing ever marked it processed.
+     *
+     * `dropMessage` is what "stop re-running this" means for the caller's
+     * surface. Marking the key processed is right for a message, but a todo is
+     * re-fetched by fingerprint and a document notification carries its own
+     * key, so those pass their own.
+     */
+    private recordInboundFailure;
+    private clearInboundFailure;
+    private rememberPendingMessage;
+    private removePendingMessage;
+    private processDocumentNotification;
+    private replayPendingMessages;
+    private replayPendingDocumentNotifications;
+    private hasPendingDocumentNotification;
+    private rememberPendingDocumentNotification;
+    private removePendingDocumentNotification;
+    private deferPendingDocumentNotification;
+    private reactionKey;
+    private rememberInboundReactionTarget;
+    private logReactionFailure;
+    private untrackSessionReaction;
+    private startReaction;
+    private stopReaction;
+    protected onTaskLifecycle(event: ChannelTaskLifecycleEvent): void;
+    onSessionDied(sessionId: string): void;
+    private isSelfMessage;
+    private readDocumentContext;
+    private rememberImTarget;
+    private findImTarget;
+    private markProcessedMessage;
+}
+export {};
+//# sourceMappingURL=dws-channel.d.ts.map

package/dist/dws-channel.d.ts.map

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