@clawhive/openclaw-plugin 0.2.0

package/dist/src/agency-install/claimLoop.js

@@ -0,0 +1,188 @@
+import { DEFAULT_ACTIVE_POLL_MS, DEFAULT_IDLE_POLL_MS, DEFAULT_RETRY_POLL_MS, jitterPollDelay, } from "../claimPolling.js";
+import { runExclusiveInstall } from "../installMutex.js";
+import { addInstallBreadcrumb, captureInstallFailure } from "../telemetry.js";
+import { executeInstallJob } from "../market-install/executor.js";
+/**
+ * Poll Agency install jobs and reuse the existing manifest executor with Agency endpoints.
+ */
+export class AgencyInstallClaimLoop {
+    options;
+    timer = null;
+    wakeTimer = null;
+    wakePending = false;
+    claiming = false;
+    running = false;
+    activeRun = null;
+    lastError = null;
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        void this.tick(true);
+    }
+    async stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.wakeTimer) {
+            clearTimeout(this.wakeTimer);
+            this.wakeTimer = null;
+        }
+        this.wakePending = false;
+        if (this.activeRun) {
+            await this.activeRun;
+        }
+        this.options.onActiveInstallChange?.(null);
+    }
+    getLastError() {
+        return this.lastError;
+    }
+    wake() {
+        if (!this.running) {
+            return;
+        }
+        this.wakePending = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.wakeTimer) {
+            return;
+        }
+        this.wakeTimer = setTimeout(() => {
+            this.wakeTimer = null;
+            if (!this.running || !this.wakePending) {
+                return;
+            }
+            this.wakePending = false;
+            void this.tick(false);
+        }, 25);
+    }
+    schedule(delayMs) {
+        if (!this.running) {
+            return;
+        }
+        const nextDelayMs = jitterPollDelay(delayMs);
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick(false);
+        }, nextDelayMs);
+    }
+    async tick(initial) {
+        if (!this.running) {
+            return;
+        }
+        if (this.claiming) {
+            this.wakePending = true;
+            return;
+        }
+        if (this.activeRun) {
+            return;
+        }
+        this.claiming = true;
+        try {
+            const result = await this.options.api.claimAgencyInstallJob({
+                pluginNodeId: this.options.pluginNodeId,
+                userId: this.options.userId,
+            });
+            this.claiming = false;
+            if (!result.job) {
+                this.lastError = null;
+                this.schedule(this.options.idlePollMs ?? DEFAULT_IDLE_POLL_MS);
+                return;
+            }
+            this.activeRun = this.processJob(result.job).finally(() => {
+                this.activeRun = null;
+                this.options.onActiveInstallChange?.(null);
+            });
+            await this.activeRun;
+            this.lastError = null;
+            this.schedule(DEFAULT_ACTIVE_POLL_MS);
+        }
+        catch (error) {
+            this.lastError = error;
+            const reason = error instanceof Error ? error.message : String(error);
+            this.options.logger?.warn(`ClawHive Agency install claim loop failed initial=${initial}: ${reason}`);
+            this.schedule(this.options.retryPollMs ?? DEFAULT_RETRY_POLL_MS);
+        }
+        finally {
+            if (this.claiming) {
+                this.claiming = false;
+            }
+            if (this.running && this.wakePending && !this.activeRun) {
+                this.wake();
+            }
+        }
+    }
+    async processJob(job) {
+        const pushStage = (stage) => {
+            this.options.onActiveInstallChange?.({
+                jobId: job.jobId,
+                listingId: job.listingId,
+                listingName: job.listingName,
+                releaseId: job.releaseId,
+                version: job.version,
+                targetNodeId: job.targetNodeId,
+                targetNodeName: job.targetNodeName,
+                stage,
+                updatedAt: new Date().toISOString(),
+            });
+        };
+        pushStage("claimed");
+        const executorApi = Object.create(this.options.api);
+        executorApi.updateInstallJob = this.options.api.updateAgencyInstallJob.bind(this.options.api);
+        executorApi.fetchInstallManifest =
+            this.options.api.fetchAgencyInstallManifest.bind(this.options.api);
+        try {
+            await runExclusiveInstall(() => executeInstallJob(job, {
+                api: executorApi,
+                pluginApi: this.options.pluginApi,
+                pluginNodeId: this.options.pluginNodeId,
+                userId: this.options.userId,
+                pluginVersion: this.options.pluginVersion,
+                openClawVersion: this.options.openClawVersion,
+                logger: this.options.logger ?? console,
+                onStageChange: pushStage,
+                onAgentsSynced: this.options.onAgentsSynced,
+                requireClaimedArtifact: false,
+            }));
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            this.options.logger?.warn(`ClawHive Agency install executor crashed for job ${job.jobId}: ${reason}`);
+            pushStage("failed");
+            addInstallBreadcrumb({
+                stage: "executor-crashed",
+                job,
+                reasonKind: "install_apply_failed",
+                data: { error: reason },
+            });
+            captureInstallFailure({
+                error,
+                reasonKind: "install_apply_failed",
+                job,
+            });
+            await this.options.api.updateAgencyInstallJob({
+                pluginNodeId: this.options.pluginNodeId,
+                jobId: job.jobId,
+                userId: this.options.userId,
+                status: "failed",
+                reasonKind: "install_apply_failed",
+                errorMessage: reason,
+                details: {
+                    crashDuring: "agency-claim-loop",
+                    listingId: job.listingId,
+                    releaseId: job.releaseId,
+                    targetNodeId: job.targetNodeId,
+                    version: job.version,
+                },
+            });
+        }
+    }
+}

package/dist/src/agent-panel/claimLoop.d.ts

@@ -0,0 +1,32 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { ClawHiveCloudApi } from "../client.js";
+export type AgentPanelClaimLoopLogger = {
+    warn: (message: string) => void;
+};
+export type AgentPanelClaimLoopOptions = {
+    api: ClawHiveCloudApi;
+    pluginApi: OpenClawPluginApi;
+    pluginNodeId: string;
+    userId: string;
+    logger?: AgentPanelClaimLoopLogger;
+    idlePollMs?: number;
+    retryPollMs?: number;
+};
+export declare class AgentPanelClaimLoop {
+    private readonly options;
+    private timer;
+    private wakeTimer;
+    private wakePending;
+    private claiming;
+    private running;
+    private activeRun;
+    private lastError;
+    constructor(options: AgentPanelClaimLoopOptions);
+    start(): void;
+    stop(): Promise<void>;
+    getLastError(): unknown;
+    wake(): void;
+    private schedule;
+    private tick;
+    private processTurn;
+}

package/dist/src/agent-panel/claimLoop.js

@@ -0,0 +1,118 @@
+import { DEFAULT_ACTIVE_POLL_MS, DEFAULT_IDLE_POLL_MS, DEFAULT_RETRY_POLL_MS, jitterPollDelay, } from "../claimPolling.js";
+import { clawhiveRuntimeStore } from "../runtime.js";
+import { executePanelTurn } from "./executor.js";
+export class AgentPanelClaimLoop {
+    options;
+    timer = null;
+    wakeTimer = null;
+    wakePending = false;
+    claiming = false;
+    running = false;
+    activeRun = null;
+    lastError = null;
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        void this.tick(true);
+    }
+    async stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.wakeTimer) {
+            clearTimeout(this.wakeTimer);
+            this.wakeTimer = null;
+        }
+        this.wakePending = false;
+        if (this.activeRun) {
+            await this.activeRun;
+        }
+    }
+    getLastError() {
+        return this.lastError;
+    }
+    wake() {
+        if (!this.running)
+            return;
+        this.wakePending = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.wakeTimer)
+            return;
+        this.wakeTimer = setTimeout(() => {
+            this.wakeTimer = null;
+            if (!this.running || !this.wakePending) {
+                return;
+            }
+            this.wakePending = false;
+            void this.tick(false);
+        }, 25);
+    }
+    schedule(delayMs) {
+        if (!this.running)
+            return;
+        const nextDelayMs = jitterPollDelay(delayMs);
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick(false);
+        }, nextDelayMs);
+    }
+    async tick(initial) {
+        if (!this.running)
+            return;
+        if (this.claiming) {
+            this.wakePending = true;
+            return;
+        }
+        if (this.activeRun) {
+            return;
+        }
+        this.claiming = true;
+        try {
+            const result = await this.options.api.claimPanelTurn({
+                pluginNodeId: this.options.pluginNodeId,
+                userId: this.options.userId,
+            });
+            this.claiming = false;
+            if (!result.turn) {
+                this.lastError = null;
+                this.schedule(this.options.idlePollMs ?? DEFAULT_IDLE_POLL_MS);
+                return;
+            }
+            this.activeRun = this.processTurn(result.turn).finally(() => {
+                this.activeRun = null;
+            });
+            await this.activeRun;
+            this.lastError = null;
+            this.schedule(DEFAULT_ACTIVE_POLL_MS);
+        }
+        catch (error) {
+            this.lastError = error;
+            const reason = error instanceof Error ? error.message : String(error);
+            this.options.logger?.warn(`ClawHive panel claim loop failed initial=${initial}: ${reason}`);
+            this.schedule(this.options.retryPollMs ?? DEFAULT_RETRY_POLL_MS);
+        }
+        finally {
+            if (this.claiming) {
+                this.claiming = false;
+            }
+            if (this.running && this.wakePending && !this.activeRun) {
+                this.wake();
+            }
+        }
+    }
+    async processTurn(turn) {
+        await executePanelTurn({
+            runtime: clawhiveRuntimeStore.getRuntime(),
+            turn,
+        });
+    }
+}

package/dist/src/agent-panel/executor.d.ts

@@ -0,0 +1,8 @@
+import { type ClawHiveRuntime } from "../runtime.js";
+import type { ClaimedPanelTurn } from "./types.js";
+export declare function executePanelTurn(options: {
+    runtime: ClawHiveRuntime;
+    turn: ClaimedPanelTurn;
+    panelistTimeoutMs?: number;
+    moderatorTimeoutMs?: number;
+}): Promise<void>;