openclaw-lark-multi-agent 1.5.1 → 1.7.0

package/dist/go-controller.d.ts

@@ -0,0 +1,148 @@
+import type { GoExecutorResult } from "./go-execution.js";
+/** Independent LMA supervision. MessageStore owns objective, criteria and completion. */
+import { type GoRuntimeSnapshot } from "./go-runtime-gate.js";
+export type GoClient = {
+    /** Backed by plugin enforced runtime policy, never a prompt assertion. */
+    verifyGoSafety?(executorKey: string): Promise<{
+        checkerToolsIsolated: boolean;
+        exactTaskAndDeliveryGate: boolean;
+        guardedSend: boolean;
+    }>;
+    sendGoGuarded?(p: {
+        sessionKey: string;
+        sessionId: string;
+        expectedLeafEntryId: string | null;
+        message: string;
+        idempotencyKey: string;
+    }): Promise<{
+        runId: string;
+    }>;
+    collectGoRun?(p: {
+        runId: string;
+        sessionKey: string;
+        timeoutMs: number;
+        sessionId?: string;
+    }): Promise<string>;
+    collectGoExecutorRun?(p: {
+        runId: string;
+        sessionKey: string;
+        sessionId: string;
+        timeoutMs: number;
+    }): Promise<GoExecutorResult>;
+    readGoExecutorRunResult?(p: {
+        runId: string;
+        sessionKey: string;
+        sessionId: string;
+    }): Promise<GoExecutorResult | null>;
+    readGoRunResult?(p: {
+        sessionKey: string;
+        sessionId: string;
+        runId: string;
+    }): Promise<string | null>;
+    reconcileGoSend?(p: {
+        sessionKey: string;
+        sessionId: string;
+        idempotencyKey: string;
+    }): Promise<{
+        runId: string;
+    } | null>;
+    initializeGoRuntime?(p: {
+        goId: number;
+        goal: string;
+        executorSessionKey: string;
+        executorSessionId: string;
+        checkerSessionKey: string;
+        checkerSessionId: string;
+    }): Promise<{
+        nativeGoalId?: string;
+        executorSessionId: string;
+        checkerSessionId: string;
+        checkerRunId: string;
+        executorRunIds: string[];
+        goalUpdatedAt?: number;
+        goalRevision?: number;
+    }>;
+    readGoRuntimeSnapshot?(sessionKey: string, sessionId: string): Promise<GoRuntimeSnapshot>;
+    getSessionInfo(key: string): Promise<any>;
+    getGoSessionInfo?(key: string): Promise<any>;
+    getSessionRuntimeStatus(key: string): Promise<any>;
+    createSession(params: {
+        key: string;
+        model: string;
+        label?: string;
+    }): Promise<any>;
+};
+export type GoControllerDeps = {
+    botName: string;
+    fallbackModel: string;
+    store: import("./message-store.js").MessageStore;
+    client: GoClient;
+    /** Executor session key for a chat (e.g. lma-<bot>-<chatId>). */
+    executorSessionKeyFor: (chatId: string) => string;
+    /** Feishu group/p2p notification. */
+    notify: (chatId: string, text: string) => Promise<unknown>;
+    /** Feishu reply to the command message. */
+    reply: (messageId: string, text: string) => Promise<unknown>;
+    /** Register/deliver an exact executor result through the ordinary durable outbox. */
+    deliverExecutorResult?: (chatId: string, result: GoExecutorResult, goId: number) => Promise<void>;
+    log?: (msg: string) => void;
+};
+type ParsedVerdict = {
+    action: "WAIT" | "CONTINUE" | "COMPLETE";
+    summary: string;
+    missing: string[];
+    message: string;
+    evidenceRefs: string[];
+    criteriaEvidence: Record<string, string[]>;
+};
+/** Strict single JSON object; no surrounding prose, extra fields or truncation. */
+export declare function parseGoVerdict(raw: string): ParsedVerdict | {
+    error: string;
+};
+export declare class GoController {
+    private readonly d;
+    private disposed;
+    private readonly timers;
+    private readonly cancelledStarts;
+    private readonly starting;
+    private readonly inFlightCycles;
+    constructor(d: GoControllerDeps);
+    private log;
+    private jobKey;
+    footerMarker(chatId: string): string | null;
+    private guardedRequest;
+    handleGoCommand(chatId: string, messageId: string, args: string): Promise<unknown>;
+    private replyStatus;
+    private safetyUnavailable;
+    private start;
+    private startReserved;
+    /** Called after the bridge has cleared only the original command pending row. */
+    onCommandSettled(chatId: string): void;
+    private pauseByChat;
+    private reconcileSends;
+    private deliverExecutorAction;
+    private resumeByChat;
+    private stopByChat;
+    /** Pause supervision without a command reply (e.g. as a /stop side-effect). */
+    pauseSilently(chatId: string, reason: string): Promise<void>;
+    /** Any new authorized human input invalidates an outstanding verdict immediately. */
+    onHumanInput(chatId: string): void;
+    /** Executor session was reset/replaced/archived: pause supervision, never auto-migrate. */
+    onExecutorSessionChanged(chatId: string, reason: string): Promise<void>;
+    /** Record a terminal run outcome as evidence (dedup by sourceKey), then arm a debounced check. */
+    notifyRunOutcome(chatId: string, kind: "assistant_reply" | "run_error" | "no_reply", sourceKey: string, content: string): void;
+    /** Terminal/delivery evidence of a Controller-owned run stays with its own job,
+     * even if /go stop + a new Go happened while it was running. */
+    notifyExactRunOutcome(goId: number, kind: "assistant_reply" | "run_error" | "no_reply", sourceKey: string, content: string, sessionId: string, runId: string): void;
+    private clearTimer;
+    private scheduleCheck;
+    private executorBusy;
+    private runCheckCycle;
+    private bootstrapExecutor;
+    private runCheck;
+    private applyVerdict;
+    /** Re-verify active jobs after a process restart; pause on executor generation mismatch. */
+    recoverOnStartup(): Promise<void>;
+    dispose(): void;
+}
+export {};