openclaw-channel-dmwork 0.5.20 → 0.6.0-dev.cea9ee46

package/dist/cli/install.js

@@ -1,151 +1,245 @@
 /**
- * install command: install plugin via official CLI + interactive config setup.
+ * install command: install or update the DMWork plugin.
+ * Pure plugin management — does NOT configure bots or bindings.
  *
- * Only manages channels.dmwork account config. Agent creation (binding,
- * workspace, agent.md) is left to the user via `openclaw agents add`.
+ * Handles 5 scenarios:
+ * 1. Legacy migration (dmwork → openclaw-channel-dmwork)
+ * 2. Normal update (check version, update if needed)
+ * 3. Fresh install (nothing installed)
+ * 4. Deadlock repair (channels.dmwork exists but no plugin)
+ * 5. Broken install cleanup
+ */
+import { copyFileSync, existsSync, rmSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { cleanupBrokenInstall, deleteLegacyBackup, detectScenario, ensurePluginsAllow, gatewayRestart, getConfigFilePathSafe, isHealthyInstall, pluginsInspect, pluginsInstall, readConfigFromFile, removeLegacyFromConfig, renameLegacyDir, restoreChannelConfigFromDisk, restoreLegacyDir, saveChannelConfigToDisk, removeChannelConfigFromFile, } from "./openclaw-cli.js";
+import { PLUGIN_ID, ensureOpenClawCompat, } from "./utils.js";
+function getLatestNpmVersion(tag) {
+    try {
+        return execFileSync("npm", ["view", `${PLUGIN_ID}@${tag}`, "version"], {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * install command: install or update the DMWork plugin.
+ * Pure plugin management — does NOT configure bots or bindings.
+ * Use `bind` or `quickstart` for bot configuration after install.
  */
-import { configGet, configGetJson, configSet, configUnset, gatewayRestart, pluginsInspect, pluginsInstall, } from "./openclaw-cli.js";
-import { PLUGIN_ID, RECOMMENDED_DM_SCOPE, confirm, ensureOpenClawCompat, isInteractive, prompt, validateAccountId, } from "./utils.js";
 export async function runInstall(opts) {
-    // 1. Pre-check
     ensureOpenClawCompat();
-    // 2. Plugin install (delegate to official CLI)
-    const inspect = pluginsInspect(PLUGIN_ID);
-    if (inspect?.plugin && !opts.force) {
-        console.log(`DMWork plugin is already installed (v${inspect.plugin.version}). Skipping install.`);
+    const scenario = detectScenario();
+    const tag = opts.dev ? "dev" : "latest";
+    const spec = opts.dev ? `${PLUGIN_ID}@dev` : PLUGIN_ID;
+    const quiet = false;
+    let didChange = false;
+    switch (scenario) {
+        case "legacy":
+            runLegacyMigration(spec, quiet, opts.force);
+            didChange = true;
+            break;
+        case "update": {
+            // Already installed — compare against target version
+            const inspect = pluginsInspect(PLUGIN_ID);
+            const currentVersion = inspect?.plugin?.version ?? "unknown";
+            if (opts.force) {
+                // --force: skip version check, always install target spec
+                console.log(`Force installing DMWork plugin${opts.dev ? " (dev)" : ""}...`);
+                pluginsInstall(spec, quiet, true);
+                console.log("Plugin installed successfully.");
+                didChange = true;
+                break;
+            }
+            const targetVersion = getLatestNpmVersion(tag);
+            if (!targetVersion) {
+                // Cannot determine target — skip install and restart
+                console.log(`Cannot reach npm registry to check ${tag} version.`);
+                console.log(`Current version: v${currentVersion}`);
+                return;
+            }
+            if (currentVersion === targetVersion) {
+                console.log(`DMWork plugin v${currentVersion} is already the target version${opts.dev ? " (dev)" : ""}. No update needed.`);
+                return; // Nothing changed — skip gateway restart
+            }
+            console.log(`Updating DMWork plugin: v${currentVersion} → v${targetVersion}${opts.dev ? " (dev)" : ""}...`);
+            pluginsInstall(spec, quiet, true); // Always use spec with tag so @dev is respected
+            console.log(`DMWork plugin updated from v${currentVersion} to v${targetVersion}${opts.dev ? " (dev)" : ""}.`);
+            didChange = true;
+            break;
+        }
+        case "broken": {
+            console.log("Detected broken plugin install. Cleaning up...");
+            const actions = cleanupBrokenInstall();
+            actions.forEach((a) => console.log(`  ${a}`));
+            console.log(`Installing DMWork plugin${opts.dev ? " (dev)" : ""}...`);
+            pluginsInstall(spec, quiet, opts.force);
+            console.log("Plugin installed successfully.");
+            didChange = true;
+            break;
+        }
+        case "deadlock":
+            runDeadlockRepair(spec, quiet);
+            didChange = true;
+            break;
+        case "fresh":
+            console.log(`Installing DMWork plugin${opts.dev ? " (dev)" : ""}...`);
+            pluginsInstall(spec, quiet, opts.force);
+            console.log("Plugin installed successfully.");
+            didChange = true;
+            break;
     }
-    else {
-        const spec = opts.dev ? `${PLUGIN_ID}@dev` : PLUGIN_ID;
-        console.log(`Installing DMWork plugin${opts.dev ? " (dev)" : ""}...`);
-        pluginsInstall(spec, false, opts.force);
-        console.log("Plugin installed successfully.");
-    }
-    // 3. Legacy config migration
-    await migrateLegacyConfig();
-    // 4. DMWork config (unless --skip-config)
-    if (!opts.skipConfig) {
-        await configureDmworkAccount(opts);
-    }
-    // 5. Gateway restart
+    if (!didChange)
+        return;
+    // Gateway restart (plugin lifecycle requires restart)
     console.log("Restarting gateway...");
     if (!gatewayRestart()) {
         console.log("Warning: Gateway restart failed. Run 'openclaw gateway restart' manually.");
     }
-    // 6. Success
-    console.log("\nDMWork plugin setup complete!");
+    console.log("\nDMWork plugin ready! Use BotFather /newbot or /quickstart to configure bots.");
 }
 // ---------------------------------------------------------------------------
-// Legacy config migration
+// Scenario 1: Legacy migration (dmwork → openclaw-channel-dmwork)
 // ---------------------------------------------------------------------------
-async function migrateLegacyConfig() {
-    const legacyToken = configGet("channels.dmwork.botToken");
-    const accounts = configGetJson("channels.dmwork.accounts");
-    // Has top-level botToken but no accounts map → legacy flat config
-    if (legacyToken && (!accounts || Object.keys(accounts).length === 0)) {
-        console.log("Detected legacy flat config. Migrating to accounts model...");
-        // Copy token to accounts.default
-        configSet("channels.dmwork.accounts.default.botToken", legacyToken);
-        // Copy apiUrl if present
-        const legacyApiUrl = configGet("channels.dmwork.apiUrl");
-        if (legacyApiUrl) {
-            configSet("channels.dmwork.accounts.default.apiUrl", legacyApiUrl);
-        }
-        // Remove top-level botToken (keep apiUrl as shared default)
-        configUnset("channels.dmwork.botToken");
-        console.log("Migrated legacy config to accounts.default.");
+function runLegacyMigration(spec, quiet, force, skipConfig) {
+    console.log("Detected legacy DMWork plugin (dmwork). Starting migration...");
+    // 1. Backup everything to disk
+    const configPath = getConfigFilePathSafe();
+    const backupPath = configPath + ".dmwork-upgrade-backup";
+    copyFileSync(configPath, backupPath);
+    saveChannelConfigToDisk();
+    console.log("  Backed up config and channels.dmwork to disk.");
+    // 2. Clean up any broken new plugin install from a previous failed attempt
+    const brokenActions = cleanupBrokenInstall();
+    if (brokenActions.length > 0) {
+        console.log("  Cleaned up broken previous install:");
+        brokenActions.forEach((a) => console.log(`    ${a}`));
     }
-}
-// ---------------------------------------------------------------------------
-// Account configuration
-// ---------------------------------------------------------------------------
-async function configureDmworkAccount(opts) {
-    // Collect accountId
-    let accountId = opts.accountId;
-    if (!accountId) {
-        accountId = await prompt("Enter bot account ID (e.g. my_bot):");
-        if (!accountId) {
-            console.log("No account ID provided. Skipping config.");
-            return;
+    // 3. Remove legacy from config FIRST (breaks deadlock)
+    removeLegacyFromConfig();
+    console.log("  Removed legacy config entries.");
+    // 3. Rename legacy directory (not delete!)
+    const legacyDirExists = existsSync(getConfigFilePathSafe().replace(/openclaw\.json$/, "extensions/dmwork"));
+    let renamed = false;
+    if (legacyDirExists) {
+        renamed = renameLegacyDir();
+        if (renamed) {
+            console.log("  Renamed extensions/dmwork → .dmwork-backup.");
+        }
+        else {
+            // Cannot isolate old directory — abort to prevent conflict
+            console.error("  Failed to rename extensions/dmwork. Aborting migration.");
+            try {
+                copyFileSync(backupPath, configPath);
+            }
+            catch { /* best effort */ }
+            throw new Error("Legacy migration aborted: could not rename extensions/dmwork");
         }
     }
-    if (!validateAccountId(accountId)) {
-        console.error(`Error: Invalid account ID "${accountId}". Only letters, digits, and underscores are allowed.`);
-        process.exit(1);
+    // 4. Install new plugin
+    try {
+        console.log("  Installing openclaw-channel-dmwork...");
+        pluginsInstall(spec, quiet, force);
     }
-    // Check if account already exists
-    const existingToken = configGet(`channels.dmwork.accounts.${accountId}.botToken`);
-    if (existingToken) {
-        if (!isInteractive()) {
-            if (opts.botToken && opts.apiUrl) {
-                console.log(`Overwriting existing account "${accountId}".`);
-            }
-            else if (opts.botToken || opts.apiUrl) {
-                console.error(`Error: Account "${accountId}" already exists. Provide both --bot-token and --api-url to overwrite.`);
-                process.exit(1);
-            }
-            else {
-                console.log(`Account "${accountId}" already configured. Keeping existing config.`);
-                ensureDmScope();
-                printAgentHint(accountId);
-                return;
-            }
+    catch (installErr) {
+        // FAIL: restore everything
+        console.error("  Install failed! Restoring previous state...");
+        if (renamed)
+            restoreLegacyDir();
+        try {
+            copyFileSync(backupPath, configPath);
         }
-        else {
-            const keep = await confirm(`Bot account "${accountId}" is already configured. Keep current config?`, true);
-            if (keep) {
-                console.log("Keeping existing config.");
-                ensureDmScope();
-                printAgentHint(accountId);
-                return;
-            }
+        catch { /* best effort */ }
+        console.error("  Previous state restored. Legacy plugin should still work.");
+        throw installErr;
+    }
+    // 5. Verify healthy install
+    if (!isHealthyInstall()) {
+        console.error("  Install completed but verification failed. Restoring...");
+        if (renamed)
+            restoreLegacyDir();
+        try {
+            copyFileSync(backupPath, configPath);
         }
+        catch { /* best effort */ }
+        console.error("  Previous state restored.");
+        throw new Error("Legacy migration failed: post-install verification did not pass");
     }
-    // Collect botToken
-    let botToken = opts.botToken;
-    if (!botToken) {
-        botToken = await prompt("Enter bot token (bf_...):");
-    }
-    if (!botToken?.startsWith("bf_")) {
-        console.error("Error: Bot token must start with 'bf_'.");
-        process.exit(1);
-    }
-    // Collect apiUrl
-    let apiUrl = opts.apiUrl;
-    if (!apiUrl) {
-        apiUrl = await prompt("Enter API server URL:");
-    }
-    if (!apiUrl) {
-        console.error("Error: API URL is required.");
-        process.exit(1);
-    }
-    // Write account config
-    configSet(`channels.dmwork.accounts.${accountId}.botToken`, botToken);
-    configSet(`channels.dmwork.accounts.${accountId}.apiUrl`, apiUrl);
-    console.log(`Configured bot account: ${accountId}`);
-    console.log(`  API: ${apiUrl}`);
-    ensureDmScope();
-    printAgentHint(accountId);
+    // 6. Success: restore channels.dmwork + cleanup
+    ensurePluginsAllow();
+    restoreChannelConfigFromDisk();
+    // Verify config was actually restored before deleting backups
+    const restoredCfg = readConfigFromFile();
+    if (restoredCfg?.channels?.dmwork) {
+        // Config restore succeeded — safe to delete backups
+        deleteLegacyBackup();
+        try {
+            rmSync(backupPath, { force: true });
+        }
+        catch { /* best effort */ }
+    }
+    else {
+        console.log("  Warning: channels.dmwork restore may not have succeeded. Keeping backups for safety.");
+    }
+    console.log("  Legacy migration complete!");
 }
 // ---------------------------------------------------------------------------
-// session.dmScope
+// Scenario 4: Deadlock repair
 // ---------------------------------------------------------------------------
-function ensureDmScope() {
-    const current = configGet("session.dmScope");
-    if (!current) {
-        configSet("session.dmScope", RECOMMENDED_DM_SCOPE);
+function runDeadlockRepair(spec, quiet, skipConfig) {
+    console.log("Detected config deadlock (channels.dmwork exists but no plugin).");
+    // 1. Backup
+    const configPath = getConfigFilePathSafe();
+    const backupPath = configPath + ".dmwork-upgrade-backup";
+    copyFileSync(configPath, backupPath);
+    saveChannelConfigToDisk();
+    // 2. Remove channels.dmwork
+    removeChannelConfigFromFile();
+    console.log("  Temporarily removed channels.dmwork.");
+    // 3. Install
+    try {
+        console.log("  Installing openclaw-channel-dmwork...");
+        pluginsInstall(spec, quiet);
     }
-    else if (current !== RECOMMENDED_DM_SCOPE) {
-        console.log(`Warning: session.dmScope is "${current}" (recommended: ${RECOMMENDED_DM_SCOPE})`);
+    catch (installErr) {
+        console.error("  Install failed! Restoring config...");
+        try {
+            copyFileSync(backupPath, configPath);
+        }
+        catch { /* best effort */ }
+        throw installErr;
+    }
+    // 4. Verify
+    if (!isHealthyInstall()) {
+        console.error("  Install completed but verification failed. Restoring config...");
+        try {
+            copyFileSync(backupPath, configPath);
+        }
+        catch { /* best effort */ }
+        throw new Error("Deadlock repair failed: post-install verification did not pass");
+    }
+    // 5. Success
+    ensurePluginsAllow();
+    restoreChannelConfigFromDisk();
+    // Verify config was restored before deleting backup
+    const restoredCfg = readConfigFromFile();
+    if (restoredCfg?.channels?.dmwork) {
+        try {
+            rmSync(backupPath, { force: true });
+        }
+        catch { /* best effort */ }
+        console.log("  Deadlock repaired!");
+    }
+    else {
+        // Config restore failed — plugin is installed but bot config is missing
+        throw new Error("Deadlock repair incomplete: plugin installed but channels.dmwork could not be restored. Backup kept at " + backupPath);
     }
 }
 // ---------------------------------------------------------------------------
-// Agent hint
+// Exported for update.ts and doctor.ts to reuse
 // ---------------------------------------------------------------------------
-function printAgentHint(accountId) {
-    const agentName = accountId.replace(/_bot$/, "");
-    console.log(`
-To create an independent agent for this bot (optional):
-  openclaw agents add ${agentName}
-  openclaw agents bind ${agentName} dmwork ${accountId}`);
-}
+export { runLegacyMigration as runLegacyMigrationForUpdate };
+export { runDeadlockRepair as runDeadlockRepairForUpdate };
 //# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../cli/install.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,MAAM,EACN,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAWpB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,eAAe;IACf,oBAAoB,EAAE,CAAC;IAEvB,+CAA+C;IAC/C,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CACT,wCAAwC,OAAO,CAAC,MAAM,CAAC,OAAO,sBAAsB,CACrF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtE,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAED,6BAA6B;IAC7B,MAAM,mBAAmB,EAAE,CAAC;IAE5B,0CAA0C;IAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CACT,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,aAAa;IACb,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AACjD,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,KAAK,UAAU,mBAAmB;IAChC,MAAM,WAAW,GAAG,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC,0BAA0B,CAAC,CAAC;IAE3D,kEAAkE;IAClE,IAAI,WAAW,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAE3E,iCAAiC;QACjC,SAAS,CAAC,2CAA2C,EAAE,WAAW,CAAC,CAAC;QAEpE,yBAAyB;QACzB,MAAM,YAAY,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACzD,IAAI,YAAY,EAAE,CAAC;YACjB,SAAS,CAAC,yCAAyC,EAAE,YAAY,CAAC,CAAC;QACrE,CAAC;QAED,4DAA4D;QAC5D,WAAW,CAAC,0BAA0B,CAAC,CAAC;QAExC,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,KAAK,UAAU,sBAAsB,CAAC,IAAoB;IACxD,oBAAoB;IACpB,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CACX,8BAA8B,SAAS,uDAAuD,CAC/F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,SAAS,CAC7B,4BAA4B,SAAS,WAAW,CACjD,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,IAAI,CAAC,CAAC;YAC9D,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CACX,mBAAmB,SAAS,wEAAwE,CACrG,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,gDAAgD,CAAC,CAAC;gBACnF,aAAa,EAAE,CAAC;gBAChB,cAAc,CAAC,SAAS,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,gBAAgB,SAAS,+CAA+C,EACxE,IAAI,CACL,CAAC;YACF,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,aAAa,EAAE,CAAC;gBAChB,cAAc,CAAC,SAAS,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iBAAiB;IACjB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,SAAS,CAAC,4BAA4B,SAAS,WAAW,EAAE,QAAQ,CAAC,CAAC;IACtE,SAAS,CAAC,4BAA4B,SAAS,SAAS,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IAEhC,aAAa,EAAE,CAAC;IAChB,cAAc,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,aAAa;IACpB,MAAM,OAAO,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,OAAO,KAAK,oBAAoB,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CACT,gCAAgC,OAAO,mBAAmB,oBAAoB,GAAG,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,SAAS,cAAc,CAAC,SAAiB;IACvC,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC;;wBAEU,SAAS;yBACR,SAAS,WAAW,SAAS,EAAE,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../cli/install.ts"],"names":[],"mappings":"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"}

package/dist/cli/openclaw-cli.d.ts

@@ -3,6 +3,8 @@
  * All openclaw invocations go through this module using execFileSync with
  * argument arrays to avoid shell-quoting issues.
  */
+/** Get the resolved openclaw binary path */
+export declare function getOpenClawBin(): string;
 export declare function getConfigFilePath(): string;
 export declare function configGet(path: string): string | null;
 export declare function configGetJson(path: string): any;
@@ -28,7 +30,41 @@ export interface PluginInspectResult {
         installPath: string;
     };
 }
+export type InspectFailReason = "unsupported" | "not_found" | "error";
+export interface PluginsInspectOutcome {
+    ok: boolean;
+    data: PluginInspectResult | null;
+    failReason: InspectFailReason | null;
+}
+/**
+ * Inspect a plugin. Returns structured outcome distinguishing:
+ * - ok + data: inspect succeeded
+ * - unsupported: old OpenClaw without `plugins inspect`
+ * - not_found: plugin genuinely not found
+ * - error: other failure (config corruption, plugin load crash, etc.)
+ */
+export declare function pluginsInspectDetailed(id: string): PluginsInspectOutcome;
+/** Backward-compatible wrapper: returns data or null. */
 export declare function pluginsInspect(id: string): PluginInspectResult | null;
+export interface PluginResolvedState {
+    installed: boolean;
+    enabled: boolean | null;
+    version: string | null;
+    installPath: string | null;
+    source: "inspect" | "fallback";
+    /** Why inspect failed. null when source === "inspect". */
+    inspectFailReason: InspectFailReason | null;
+}
+/**
+ * Resolve plugin install state. Uses `plugins inspect` when available,
+ * falls back to config entries + directory + package.json for old OpenClaw
+ * versions that don't support `plugins inspect`.
+ *
+ * Fallback installed = all 3 artifacts present (entries + installs + dir),
+ * matching detectScenario()'s healthy definition. Partial presence is NOT
+ * considered installed — that's a broken state for doctor --fix to handle.
+ */
+export declare function resolvePluginState(id: string): PluginResolvedState;
 export declare function gatewayStatus(): {
     running: boolean;
 };
@@ -45,6 +81,17 @@ export declare function saveChannelConfigFromFile(): Record<string, unknown> | n
  * Creates a .bak backup before writing.
  */
 export declare function restoreChannelConfigToFile(dmworkConfig: Record<string, unknown>): void;
+/**
+ * Remove channels.dmwork directly from the JSON file.
+ * Used before uninstall to avoid config validation errors
+ * (openclaw config unset also fails when the channel id is unknown).
+ */
+/**
+ * Get the openclaw config file path without calling the CLI.
+ * Falls back to the standard default when CLI is unavailable
+ * (e.g. during uninstall when config validation fails).
+ */
+export declare function getConfigFilePathSafe(): string;
 export declare function removeChannelConfigFromFile(): void;
 /**
  * Read the full config object directly from file (for doctor phase-1 checks).
@@ -56,3 +103,49 @@ export declare function readConfigFromFile(): Record<string, any> | null;
  * not in that list. Otherwise removes all dmwork bindings.
  */
 export declare function removeOrphanedBindingsFromFile(channel: string, validAccountIds?: string[]): void;
+/**
+ * Detect and clean up legacy DMWork plugin installations that conflict
+ * with the current openclaw-channel-dmwork plugin.
+ *
+ * Known legacy artifacts:
+ * - ~/.openclaw/extensions/dmwork/ (old plugin directory, id="dmwork")
+ * - plugins.entries.dmwork in openclaw.json
+ *
+ * Returns a list of actions taken (for logging).
+ */
+export declare function cleanupLegacyPlugin(): string[];
+/**
+ * Clean up stale openclaw-channel-dmwork directory that is not registered
+ * in plugins.installs (orphaned from a failed previous install).
+ *
+ * Only removes the directory if ALL of these are true:
+ * 1. The directory exists
+ * 2. pluginsInspect returns null (openclaw doesn't recognize it)
+ * 3. plugins.installs has no record for openclaw-channel-dmwork
+ */
+export declare function cleanupStalePluginDir(): string[];
+/**
+ * Clean up stale openclaw-install-stage directories that belong to DMWork.
+ * Only removes directories that:
+ * 1. Match .openclaw-install-stage-* pattern
+ * 2. Are older than 10 minutes (not a current installation)
+ * 3. Contain a package.json with name "openclaw-channel-dmwork"
+ */
+export declare function cleanupStaleStageDirectories(): string[];
+/**
+ * Write openclaw.json atomically: write to .tmp then rename.
+ * Prevents gateway watcher from reading half-written/truncated JSON.
+ */
+export declare function writeConfigAtomic(cfg: Record<string, any>): void;
+export type UpgradeScenario = "legacy" | "update" | "fresh" | "deadlock" | "broken";
+export declare function detectScenario(): UpgradeScenario;
+export declare function isHealthyInstall(): boolean;
+export declare function ensurePluginsAllow(): void;
+export declare function pluginsUpdateCompat(id: string, tag: string, quiet?: boolean): void;
+export declare function renameLegacyDir(): boolean;
+export declare function restoreLegacyDir(): void;
+export declare function deleteLegacyBackup(): void;
+export declare function removeLegacyFromConfig(): void;
+export declare function saveChannelConfigToDisk(): void;
+export declare function restoreChannelConfigFromDisk(): void;
+export declare function cleanupBrokenInstall(): string[];