npm - @useorgx/openclaw-plugin - Versions diffs - 0.4.3 → 0.4.5 - Mend

@useorgx/openclaw-plugin 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/README.md +72 -2
package/dashboard/dist/assets/B68j2crt.js +1 -0
package/dashboard/dist/assets/BZZ-fiJx.js +32 -0
package/dashboard/dist/assets/{CE5pVdev.js → BoXlCHKa.js} +1 -1
package/dashboard/dist/assets/Bq9x_Xyh.css +1 -0
package/dashboard/dist/assets/DBhrRVdp.js +1 -0
package/dashboard/dist/assets/DD1jv1Hd.js +8 -0
package/dashboard/dist/assets/DNjbmawF.js +214 -0
package/dashboard/dist/index.html +5 -5
package/dist/contracts/client.js +22 -2
package/dist/http-handler.js +14 -5
package/dist/index.js +259 -26
package/dist/mcp-client-setup.d.ts +30 -0
package/dist/mcp-client-setup.js +215 -0
package/dist/mcp-http-handler.d.ts +38 -0
package/dist/mcp-http-handler.js +254 -0
package/dist/telemetry/posthog.d.ts +8 -0
package/dist/telemetry/posthog.js +81 -0
package/package.json +1 -1
package/dashboard/dist/assets/BqukHQH-.js +0 -8
package/dashboard/dist/assets/Cpr7n8fE.js +0 -1
package/dashboard/dist/assets/Nip3CrNC.js +0 -1
package/dashboard/dist/assets/TN5wE36J.js +0 -1
package/dashboard/dist/assets/X6IcjS74.js +0 -212
package/dashboard/dist/assets/jyFhCND-.css +0 -1

package/dashboard/dist/index.html CHANGED Viewed

@@ -9,12 +9,12 @@
     <meta name="googlebot" content="noindex, nofollow, noarchive, nosnippet, noimageindex" />
     <meta name="copyright" content="OrgX. All rights reserved." />
     <title>OrgX Live Dashboard</title>
-    <script type="module" crossorigin src="/orgx/live/assets/X6IcjS74.js"></script>
+    <script type="module" crossorigin src="/orgx/live/assets/DNjbmawF.js"></script>
     <link rel="modulepreload" crossorigin href="/orgx/live/assets/C-KIc3Wc.js">
-    <link rel="modulepreload" crossorigin href="/orgx/live/assets/Cpr7n8fE.js">
-    <link rel="modulepreload" crossorigin href="/orgx/live/assets/BqukHQH-.js">
-    <link rel="modulepreload" crossorigin href="/orgx/live/assets/CE5pVdev.js">
-    <link rel="stylesheet" crossorigin href="/orgx/live/assets/jyFhCND-.css">
+    <link rel="modulepreload" crossorigin href="/orgx/live/assets/BZZ-fiJx.js">
+    <link rel="modulepreload" crossorigin href="/orgx/live/assets/DD1jv1Hd.js">
+    <link rel="modulepreload" crossorigin href="/orgx/live/assets/BoXlCHKa.js">
+    <link rel="stylesheet" crossorigin href="/orgx/live/assets/Bq9x_Xyh.css">
   </head>
   <body class="bg-[#080808] text-white antialiased">
     <div id="root"></div>

package/dist/contracts/client.js CHANGED Viewed

@@ -201,16 +201,36 @@ export class OrgXClient {
     // Spawn Guard (Quality Gate + Model Routing)
     // ===========================================================================
     async checkSpawnGuard(domain, taskId) {
-        return this.post("/api/client/spawn", {
+        const response = await this.post("/api/client/spawn", {
             domain,
             taskId,
         });
+        // Newer servers wrap responses in { ok, data } while older clients expect the
+        // SpawnGuardResult fields at top-level.
+        if (response &&
+            typeof response === "object" &&
+            "data" in response &&
+            response.data) {
+            return response.data;
+        }
+        return response;
     }
     // ===========================================================================
     // Quality Scores
     // ===========================================================================
     async recordQuality(score) {
-        return this.post("/api/client/quality", score);
+        const response = await this.post("/api/client/quality", score);
+        // Backwards-compatible: accept either { success: true } or { ok: true, data: ... }.
+        if (response &&
+            typeof response === "object" &&
+            "success" in response &&
+            typeof response.success === "boolean") {
+            return response;
+        }
+        if (response && typeof response === "object" && "ok" in response) {
+            return { success: Boolean(response.ok) };
+        }
+        return { success: true };
     }
     // ===========================================================================
     // Entity CRUD

package/dist/http-handler.js CHANGED Viewed

@@ -2214,13 +2214,22 @@ export function createHttpHandler(config, client, getSnapshot, onboarding, diagn
                     type: "progress",
                     timestamp,
                     payload: {
-                        phase: input.phase,
+                        // Keep this payload aligned with OrgXClient.emitActivity input
+                        // so outbox replay can forward it without shape translation.
+                        initiative_id: initiativeId,
+                        run_id: input.runId?.trim() || undefined,
+                        correlation_id: input.runId
+                            ? undefined
+                            : (input.correlationId?.trim() || `openclaw-${Date.now()}`),
+                        source_client: "openclaw",
                         message,
+                        phase: input.phase,
+                        progress_pct: typeof input.progressPct === "number" && Number.isFinite(input.progressPct)
+                            ? Math.max(0, Math.min(100, Math.round(input.progressPct)))
+                            : undefined,
                         level: input.level ?? "info",
-                        runId,
-                        initiativeId,
-                        nextStep: input.nextStep ?? null,
-                        metadata: input.metadata ?? null,
+                        next_step: input.nextStep ?? undefined,
+                        metadata: input.metadata ?? undefined,
                     },
                     activityItem,
                 });

package/dist/index.js CHANGED Viewed

@@ -22,6 +22,10 @@ import { clearPersistedSnapshot, readPersistedSnapshot, writePersistedSnapshot,
 import { appendToOutbox, readOutbox, readOutboxSummary, replaceOutbox, } from "./outbox.js";
 import { extractProgressOutboxMessage } from "./reporting/outbox-replay.js";
 import { ensureGatewayWatchdog } from "./gateway-watchdog.js";
+import { createMcpHttpHandler } from "./mcp-http-handler.js";
+import { autoConfigureDetectedMcpClients } from "./mcp-client-setup.js";
+import { readOpenClawGatewayPort, readOpenClawSettingsSnapshot } from "./openclaw-settings.js";
+import { posthogCapture } from "./telemetry/posthog.js";
 export { OrgXClient } from "./api.js";
 const DEFAULT_BASE_URL = "https://www.useorgx.com";
 const DEFAULT_DOCS_URL = "https://orgx.mintlify.site/guides/openclaw-plugin-setup";
@@ -325,6 +329,19 @@ export default function register(api) {
         api.log?.info?.("[orgx] Plugin disabled");
         return;
     }
+    void posthogCapture({
+        event: "openclaw_plugin_loaded",
+        distinctId: config.installationId,
+        properties: {
+            plugin_version: config.pluginVersion,
+            dashboard_enabled: config.dashboardEnabled,
+            has_api_key: Boolean(config.apiKey),
+            api_key_source: config.apiKeySource,
+            base_url: config.baseUrl,
+        },
+    }).catch(() => {
+        // best effort
+    });
     if (!config.apiKey) {
         api.log?.warn?.("[orgx] No API key. Set plugins.entries.orgx.config.apiKey, ORGX_API_KEY env, or ~/Code/orgx/orgx/.env.local");
     }
@@ -350,14 +367,14 @@ export default function register(api) {
     const defaultReportingCorrelationId = pickNonEmptyString(process.env.ORGX_CORRELATION_ID) ??
         `openclaw-${config.installationId}`;
     function resolveReportingContext(input) {
-        const initiativeId = pickNonEmptyString(input.initiative_id, process.env.ORGX_INITIATIVE_ID);
+        const initiativeId = pickNonEmptyString(input.initiative_id, input.initiativeId, process.env.ORGX_INITIATIVE_ID);
         if (!initiativeId || !isUuid(initiativeId)) {
             return {
                 ok: false,
                 error: "initiative_id is required (set ORGX_INITIATIVE_ID or pass initiative_id).",
             };
         }
-        const sourceCandidate = pickNonEmptyString(input.source_client, process.env.ORGX_SOURCE_CLIENT, "openclaw");
+        const sourceCandidate = pickNonEmptyString(input.source_client, input.sourceClient, process.env.ORGX_SOURCE_CLIENT, "openclaw");
         const sourceClient = sourceCandidate === "codex" ||
             sourceCandidate === "claude-code" ||
             sourceCandidate === "api" ||
@@ -368,7 +385,10 @@ export default function register(api) {
         const runId = isUuid(runIdCandidate) ? runIdCandidate : undefined;
         const correlationId = runId
             ? undefined
-            : pickNonEmptyString(input.correlation_id, defaultReportingCorrelationId, `openclaw-${Date.now()}`);
+            : pickNonEmptyString(input.correlation_id, input.correlationId,
+            // Legacy: some buffered payloads only stored a local `runId` which is
+            // better treated as a correlation key than a server-backed run_id.
+            input.runId, defaultReportingCorrelationId, `openclaw-${Date.now()}`);
         return {
             ok: true,
             value: {
@@ -391,6 +411,140 @@ export default function register(api) {
             return err.message;
         return typeof err === "string" ? err : "Unexpected error";
     }
+    const registerTool = api.registerTool.bind(api);
+    api.registerTool = (tool, options) => {
+        const toolName = tool.name;
+        const optional = Boolean(options?.optional);
+        registerTool({
+            ...tool,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            execute: async (callId, params) => {
+                const startedAt = Date.now();
+                void posthogCapture({
+                    event: "openclaw_tool_called",
+                    distinctId: config.installationId,
+                    properties: {
+                        tool_name: toolName,
+                        tool_optional: optional,
+                        call_id: callId,
+                        plugin_version: config.pluginVersion,
+                    },
+                }).catch(() => {
+                    // best effort
+                });
+                try {
+                    const result = await tool.execute(callId, params);
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_tool_succeeded",
+                        distinctId: config.installationId,
+                        properties: {
+                            tool_name: toolName,
+                            tool_optional: optional,
+                            call_id: callId,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    return result;
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_tool_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            tool_name: toolName,
+                            tool_optional: optional,
+                            call_id: callId,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+        }, options);
+    };
+    const registerService = api.registerService.bind(api);
+    api.registerService = (service) => {
+        registerService({
+            ...service,
+            start: async () => {
+                const startedAt = Date.now();
+                try {
+                    await service.start();
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_started",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_start_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+            stop: async () => {
+                const startedAt = Date.now();
+                try {
+                    await service.stop();
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_stopped",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_stop_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+        });
+    };
     function clearPairingState() {
         activePairing = null;
         updateOnboardingState({
@@ -474,6 +628,23 @@ export default function register(api) {
             installationId: config.installationId,
             workspaceName: input.workspaceName ?? onboardingState.workspaceName,
         });
+        if (input.source === "browser_pairing" &&
+            process.env.ORGX_DISABLE_MCP_CLIENT_AUTOCONFIG !== "1") {
+            try {
+                const snapshot = readOpenClawSettingsSnapshot();
+                const port = readOpenClawGatewayPort(snapshot.raw);
+                const localMcpUrl = `http://127.0.0.1:${port}/orgx/mcp`;
+                void autoConfigureDetectedMcpClients({
+                    localMcpUrl,
+                    logger: api.log ?? {},
+                }).catch(() => {
+                    // best effort
+                });
+            }
+            catch {
+                // best effort
+            }
+        }
     }
     // ---------------------------------------------------------------------------
     // 1. Background Sync Service
@@ -481,7 +652,6 @@ export default function register(api) {
     let syncTimer = null;
     let syncInFlight = null;
     let syncServiceRunning = false;
-    const outboxQueues = ["progress", "decisions", "artifacts"];
     let outboxReplayState = {
         status: "idle",
         lastReplayAttemptAt: null,
@@ -661,7 +831,11 @@ export default function register(api) {
                 throw new Error(context.error);
             }
             const rawPhase = pickStringField(payload, "phase") ?? "implementing";
-            const progressPct = typeof payload.progress_pct === "number" ? payload.progress_pct : undefined;
+            const progressPct = typeof payload.progress_pct === "number"
+                ? payload.progress_pct
+                : typeof payload.progressPct === "number"
+                    ? payload.progressPct
+                    : undefined;
             const phase = rawPhase === "intent" ||
                 rawPhase === "execution" ||
                 rawPhase === "blocked" ||
@@ -670,7 +844,11 @@ export default function register(api) {
                 rawPhase === "completed"
                 ? rawPhase
                 : toReportingPhase(rawPhase, progressPct);
-            await client.emitActivity({
+            const metaRaw = payload.metadata;
+            const meta = metaRaw && typeof metaRaw === "object" && !Array.isArray(metaRaw)
+                ? metaRaw
+                : {};
+            const emitPayload = {
                 initiative_id: context.value.initiativeId,
                 run_id: context.value.runId,
                 correlation_id: context.value.correlationId,
@@ -679,12 +857,44 @@ export default function register(api) {
                 phase,
                 progress_pct: progressPct,
                 level: pickStringField(payload, "level"),
-                next_step: pickStringField(payload, "next_step") ?? undefined,
+                next_step: pickStringField(payload, "next_step") ??
+                    pickStringField(payload, "nextStep") ??
+                    undefined,
                 metadata: {
+                    ...meta,
                     source: "orgx_openclaw_outbox_replay",
                     outbox_event_id: event.id,
                 },
-            });
+            };
+            try {
+                await client.emitActivity(emitPayload);
+            }
+            catch (err) {
+                // Some locally-buffered events carry a UUID that *looks* like an OrgX run_id
+                // but was only ever used as a local correlation/grouping key. If OrgX
+                // doesn't recognize it, retry by treating it as correlation_id so OrgX can
+                // create/attach a run deterministically.
+                const msg = toErrorMessage(err);
+                if (emitPayload.run_id &&
+                    /^404\\b/.test(msg) &&
+                    /\\brun\\b/i.test(msg) &&
+                    /not found/i.test(msg)) {
+                    await client.emitActivity({
+                        ...emitPayload,
+                        run_id: undefined,
+                        // Avoid passing a bare UUID as correlation_id since some server
+                        // paths may interpret UUIDs as run_id lookups.
+                        correlation_id: `openclaw:${emitPayload.run_id}`,
+                        metadata: {
+                            ...emitPayload.metadata,
+                            replay_run_id_as_correlation: true,
+                        },
+                    });
+                }
+                else {
+                    throw err;
+                }
+            }
             return;
         }
         if (event.type === "decision") {
@@ -770,7 +980,14 @@ export default function register(api) {
         };
         let hadReplayFailure = false;
         let lastReplayError = null;
-        for (const queue of outboxQueues) {
+        // Outbox files are keyed by *session id* (e.g. initiative/run correlation),
+        // not by event type.
+        const outboxSummary = await readOutboxSummary();
+        const queues = Object.entries(outboxSummary.pendingByQueue)
+            .filter(([, count]) => typeof count === "number" && count > 0)
+            .map(([queueId]) => queueId)
+            .sort();
+        for (const queue of queues) {
             const pending = await readOutbox(queue);
             if (pending.length === 0) {
                 continue;
@@ -1215,8 +1432,13 @@ export default function register(api) {
     // ---------------------------------------------------------------------------
     // 2. MCP Tools (Model Context Protocol compatible)
     // ---------------------------------------------------------------------------
+    const mcpToolRegistry = new Map();
+    const registerMcpTool = (tool, options) => {
+        mcpToolRegistry.set(tool.name, tool);
+        api.registerTool(tool, options);
+    };
     // --- orgx_status ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_status",
         description: "Get current OrgX org status: active initiatives, agent states, pending decisions, active tasks.",
         parameters: {
@@ -1236,7 +1458,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_sync ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_sync",
         description: "Push/pull memory sync with OrgX. Send local memory/daily log; receive initiatives, tasks, decisions, model routing policy.",
         parameters: {
@@ -1266,7 +1488,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_delegation_preflight ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_delegation_preflight",
         description: "Run delegation preflight to score scope quality, estimate ETA/cost, and suggest a split before autonomous execution.",
         parameters: {
@@ -1317,7 +1539,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_run_action ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_run_action",
         description: "Apply a control action to a run: pause, resume, cancel, or rollback (rollback requires checkpointId).",
         parameters: {
@@ -1361,7 +1583,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_checkpoints_list ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_checkpoints_list",
         description: "List checkpoints for a run.",
         parameters: {
@@ -1386,7 +1608,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_checkpoint_restore ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_checkpoint_restore",
         description: "Restore a run to a specific checkpoint.",
         parameters: {
@@ -1425,7 +1647,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_spawn_check ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_spawn_check",
         description: "Check quality gate + get model routing before spawning a sub-agent. Returns allowed/denied, model tier, and check details.",
         parameters: {
@@ -1454,7 +1676,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_quality_score ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_quality_score",
         description: "Record a quality score (1-5) for completed agent work. Used to gate future spawns and track performance.",
         parameters: {
@@ -1492,7 +1714,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_create_entity ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_create_entity",
         description: "Create an OrgX entity (initiative, workstream, task, decision, milestone, etc.).",
         parameters: {
@@ -1577,7 +1799,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_update_entity ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_update_entity",
         description: "Update an existing OrgX entity by type and ID.",
         parameters: {
@@ -1618,7 +1840,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_list_entities ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_list_entities",
         description: "List OrgX entities of a given type with optional status filter.",
         parameters: {
@@ -1760,7 +1982,7 @@ export default function register(api) {
         }
     }
     // --- orgx_emit_activity ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_emit_activity",
         description: "Emit append-only OrgX activity telemetry (launch reporting contract primary write tool).",
         parameters: {
@@ -1820,7 +2042,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_apply_changeset ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_apply_changeset",
         description: "Apply an idempotent transactional OrgX changeset (launch reporting contract primary mutation tool).",
         parameters: {
@@ -1863,7 +2085,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_report_progress (alias -> orgx_emit_activity) ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_report_progress",
         description: "Alias for orgx_emit_activity. Report progress at key milestones so the team can track your work.",
         parameters: {
@@ -1926,7 +2148,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_request_decision (alias -> orgx_apply_changeset decision.create) ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_request_decision",
         description: "Alias for orgx_apply_changeset with decision.create. Request a human decision before proceeding.",
         parameters: {
@@ -2011,7 +2233,7 @@ export default function register(api) {
         },
     }, { optional: true });
     // --- orgx_register_artifact ---
-    api.registerTool({
+    registerMcpTool({
         name: "orgx_register_artifact",
         description: "Register a work output (PR, document, config change, report, etc.) with OrgX. Makes it visible in the dashboard.",
         parameters: {
@@ -2184,7 +2406,18 @@ export default function register(api) {
     }, {
         getHealth: async (input = {}) => buildHealthReport({ probeRemote: input.probeRemote === true }),
     });
-    api.registerHttpHandler(httpHandler);
+    const mcpHttpHandler = createMcpHttpHandler({
+        tools: mcpToolRegistry,
+        logger: api.log ?? {},
+        serverName: "@useorgx/openclaw-plugin",
+        serverVersion: config.pluginVersion,
+    });
+    const compositeHttpHandler = async (req, res) => {
+        if (await mcpHttpHandler(req, res))
+            return true;
+        return await httpHandler(req, res);
+    };
+    api.registerHttpHandler(compositeHttpHandler);
     api.log?.info?.("[orgx] Plugin registered", {
         baseUrl: config.baseUrl,
         hasApiKey: !!config.apiKey,

package/dist/mcp-client-setup.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import type { Logger } from "./mcp-http-handler.js";
+export declare function patchClaudeMcpConfig(input: {
+    current: Record<string, unknown>;
+    localMcpUrl: string;
+}): {
+    updated: boolean;
+    next: Record<string, unknown>;
+};
+export declare function patchCursorMcpConfig(input: {
+    current: Record<string, unknown>;
+    localMcpUrl: string;
+}): {
+    updated: boolean;
+    next: Record<string, unknown>;
+};
+export declare function patchCodexConfigToml(input: {
+    current: string;
+    localMcpUrl: string;
+}): {
+    updated: boolean;
+    next: string;
+};
+export declare function autoConfigureDetectedMcpClients(input: {
+    localMcpUrl: string;
+    logger?: Logger;
+    homeDir?: string;
+}): Promise<{
+    updatedPaths: string[];
+    skippedPaths: string[];
+}>;