opencode-copilot-account-switcher 0.13.6 → 0.14.0

package/dist/wechat/compat/openclaw-guided-smoke.d.ts

@@ -0,0 +1,178 @@
+import { type OpenClawWeixinPublicHelpers, type OpenClawWeixinPublicHelpersLoaderOptions, type PublicWeixinMessage } from "./openclaw-public-helpers.js";
+import type { SlashOnlyCommand } from "./slash-guard.js";
+type GuidedSmokeStatus = "running" | "blocked" | "completed";
+type GuidedSmokeConclusion = "known-unknown" | "no-go" | "go";
+type GuidedSmokeSelfTestResult = {
+    ok: boolean;
+    reason?: string;
+};
+type GuidedSmokeDependencyVersions = {
+    "@tencent-weixin/openclaw-weixin": string;
+    openclaw: string;
+};
+type GuidedSmokeCheckStatus = "pass" | "fail" | "known-unknown";
+type GuidedSmokeNonSlashAttempt = {
+    input?: string;
+    inbound?: Record<string, unknown> | null;
+    warningReply?: {
+        ok?: boolean;
+        text?: string;
+        messageId?: string;
+        error?: string;
+    } | null;
+    persisted?: boolean;
+};
+type SlashCaptureState = {
+    getUpdatesBuf?: string;
+    pendingMessages?: PublicWeixinMessage[];
+};
+type GuidedPublicHelpers = Pick<OpenClawWeixinPublicHelpers, "entry" | "qrGateway" | "latestAccountState" | "getUpdates" | "sendMessageWeixin">;
+type GuidedPublicHelpersLoader = (options?: OpenClawWeixinPublicHelpersLoaderOptions) => Promise<GuidedPublicHelpers>;
+type GuidedSmokeKeyFieldsCheck = {
+    login: {
+        status: GuidedSmokeCheckStatus;
+        detail?: string;
+    };
+    getupdates: {
+        status: GuidedSmokeCheckStatus;
+        detail?: string;
+    };
+    slashInbound: {
+        status: GuidedSmokeCheckStatus;
+        detail?: string;
+    };
+    warningReply: {
+        status: GuidedSmokeCheckStatus;
+        detail?: string;
+    };
+};
+export declare const GUIDED_SMOKE_EVIDENCE_FILES: {
+    readonly preflight: "001-preflight.md";
+    readonly qrStart: "002-qr-start.md";
+    readonly loginSuccess: "003-login-success.md";
+    readonly statusCommand: "004-status-command.json";
+    readonly replyCommand: "005-reply-command.json";
+    readonly allowCommand: "006-allow-command.json";
+};
+export type GuidedSmokeRun = {
+    runId: string;
+    cwd: string;
+    evidenceBaseDir: string;
+    evidenceDir: string;
+    status: GuidedSmokeStatus;
+    conclusion: GuidedSmokeConclusion;
+};
+export type GuidedSmokeResult = {
+    runId: string;
+    status: GuidedSmokeStatus;
+    conclusion: GuidedSmokeConclusion;
+    evidenceDir: string;
+    reason?: string;
+};
+export type RunGuidedSmokeOptions = {
+    runId?: string;
+    cwd?: string;
+    evidenceBaseDir?: string;
+    qrWaitTimeoutMs?: number;
+    apiSamplesDocPath?: string;
+    goNoGoDocPath?: string;
+    loadPublicEntry?: () => Promise<{
+        entryRelativePath: string;
+    }>;
+    runSelfTest?: () => Promise<GuidedSmokeSelfTestResult>;
+    runQrLogin?: (input: {
+        waitTimeoutMs: number;
+    }) => Promise<{
+        status: "success" | "timeout";
+        connected?: boolean;
+        qrPrinted?: boolean;
+        qrUrl?: string;
+        qrDataUrl?: string;
+    } | void>;
+    captureSlashInbound?: (command: SlashOnlyCommand) => Promise<Record<string, unknown> | null>;
+    runNonSlashVerification?: () => Promise<{
+        passed: number;
+        total: number;
+        failedChecks?: string[];
+        attempts?: GuidedSmokeNonSlashAttempt[];
+        keyFieldsCheck?: Partial<GuidedSmokeKeyFieldsCheck>;
+    } | void>;
+    getDependencyVersions?: () => GuidedSmokeDependencyVersions;
+    loadOpenClawWeixinPublicHelpers?: GuidedPublicHelpersLoader;
+    publicHelpersOptions?: OpenClawWeixinPublicHelpersLoaderOptions;
+    slashCaptureWaitTimeoutMs?: number;
+    slashCapturePollIntervalMs?: number;
+};
+type PreflightData = {
+    runId: string;
+    cwd: string;
+    nodeVersion: string;
+    dependencyVersions: GuidedSmokeDependencyVersions;
+    dependencyVersionResolution: {
+        status: "pass" | "fail";
+        detail: string;
+    };
+    publicEntryLoad: {
+        status: "pass" | "fail";
+        detail: string;
+    };
+    evidenceDirectoryCreation: {
+        status: "pass" | "fail";
+        detail: string;
+    };
+    selfTest: {
+        status: "pass" | "fail";
+        detail: string;
+    };
+};
+export declare function createGuidedSmokeRun(options?: Pick<RunGuidedSmokeOptions, "runId" | "cwd" | "evidenceBaseDir">): GuidedSmokeRun;
+export declare function failGuidedSmoke(run: GuidedSmokeRun, reason?: string): GuidedSmokeResult;
+export declare function getGuidedSmokeExitCode(result: Pick<GuidedSmokeResult, "status">): number;
+export declare function writePreflightEvidence(run: GuidedSmokeRun, data: PreflightData): Promise<void>;
+declare function normalizeSlashInboundSample(input: {
+    command: SlashOnlyCommand;
+    input: string;
+    message: PublicWeixinMessage;
+}): Record<string, unknown>;
+export declare const normalizeSlashInboundSampleForTest: typeof normalizeSlashInboundSample;
+declare function captureSlashInboundFromPublicMessages(input: {
+    command: SlashOnlyCommand;
+    input: string;
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+    getMessages: () => Promise<PublicWeixinMessage[]>;
+    stashMessages?: (messages: PublicWeixinMessage[]) => void;
+}): Promise<Record<string, unknown> | null>;
+export declare const captureSlashInboundFromPublicMessagesForTest: typeof captureSlashInboundFromPublicMessages;
+declare function captureSlashInboundDefault(command: SlashOnlyCommand, deps?: {
+    state?: SlashCaptureState;
+    loadOpenClawWeixinPublicHelpers?: GuidedPublicHelpersLoader;
+    publicHelpersOptions?: OpenClawWeixinPublicHelpersLoaderOptions;
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<Record<string, unknown>>;
+export declare const captureSlashInboundDefaultForTest: typeof captureSlashInboundDefault;
+declare function runDefaultNonSlashVerification(input: {
+    state?: SlashCaptureState;
+    loadOpenClawWeixinPublicHelpers?: GuidedPublicHelpersLoader;
+    publicHelpersOptions?: OpenClawWeixinPublicHelpersLoaderOptions;
+    inputs?: string[];
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<{
+    passed: number;
+    total: number;
+    failedChecks: string[];
+    attempts: GuidedSmokeNonSlashAttempt[];
+    keyFieldsCheck: GuidedSmokeKeyFieldsCheck;
+}>;
+export declare const runDefaultNonSlashVerificationForTest: typeof runDefaultNonSlashVerification;
+declare function normalizeQrLoginResult(result: unknown): {
+    status: "success" | "timeout";
+    connected?: boolean;
+    qrPrinted?: boolean;
+    qrUrl?: string;
+} | null;
+export declare const normalizeQrLoginResultForTest: typeof normalizeQrLoginResult;
+export declare function runGuidedSmoke(options?: RunGuidedSmokeOptions): Promise<GuidedSmokeResult>;
+export {};