npm - forge-openclaw-plugin - Versions diffs - 0.2.25 → 0.2.27 - Mend

forge-openclaw-plugin 0.2.25 → 0.2.27

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 (237) hide show

package/dist/index.html CHANGED Viewed

@@ -13,15 +13,14 @@
     />
     <link rel="icon" type="image/png" href="/forge/assets/favicon-BCHm9dUV.ico" />
     <link rel="alternate icon" href="/forge/assets/favicon-BCHm9dUV.ico" />
-    <script type="module" crossorigin src="/forge/assets/index-CFCKDIMH.js"></script>
-    <link rel="modulepreload" crossorigin href="/forge/assets/viz-Cqb6s--o.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-D9PTEPSB.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/ui-nYfoC0Gq.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/motion-DvkU14p-.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/table-DgiPof9E.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/board-VmF4FAfr.js">
+    <script type="module" crossorigin src="/forge/assets/index-zYB-9Dfo.js"></script>
+    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-DoNZuFhn.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/board-C6jCchjI.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/ui-CKNPpz7q.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/motion-DFHrH2rd.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/table-ZL7Di_u3.js">
     <link rel="stylesheet" crossorigin href="/forge/assets/vendor-DT3pnAKJ.css">
-    <link rel="stylesheet" crossorigin href="/forge/assets/index-ZPY6U1TU.css">
+    <link rel="stylesheet" crossorigin href="/forge/assets/index-DVvS8iiU.css">
   </head>
   <body class="bg-canvas text-ink antialiased">
     <div id="root"></div>

package/dist/openclaw/local-runtime.d.ts CHANGED Viewed

@@ -33,7 +33,9 @@ export type ForgeRuntimeRestartResult = {
 };
 export declare function ensureForgeRuntimeReady(config: ForgePluginConfig): Promise<void>;
 export declare function startForgeRuntime(config: ForgePluginConfig): Promise<ForgeRuntimeStartResult>;
-export declare function primeForgeRuntime(config: ForgePluginConfig): void;
+export declare function primeForgeRuntime(config: ForgePluginConfig, logger?: {
+    warn?(message: string): void;
+}): void;
 export declare function stopForgeRuntime(config: ForgePluginConfig): Promise<ForgeRuntimeStopResult>;
 export declare function getForgeRuntimeStatus(config: ForgePluginConfig): Promise<ForgeRuntimeStatusResult>;
 export declare function restartForgeRuntime(config: ForgePluginConfig): Promise<ForgeRuntimeRestartResult>;

package/dist/openclaw/local-runtime.js CHANGED Viewed

@@ -165,9 +165,50 @@ function isLocalOrigin(origin) {
         return false;
     }
 }
+function isTruthyEnvFlag(value) {
+    if (!value) {
+        return false;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+function shouldEnableManagedDevWeb(plan, env = process.env) {
+    return plan.mode === "source" || isTruthyEnvFlag(env.FORGE_OPENCLAW_DEV);
+}
 function getCurrentModuleRoot() {
     return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
 }
+function buildLaunchPlanSearchPaths(moduleRoot) {
+    const repoRoot = path.resolve(moduleRoot, "..");
+    return {
+        packagedEntries: [
+            path.join(moduleRoot, "server", "index.js"),
+            path.join(moduleRoot, "dist", "server", "index.js"),
+            path.join(moduleRoot, "dist", "server", "src", "index.js"),
+            path.join(moduleRoot, "dist", "server", "server", "src", "index.js")
+        ],
+        packagedMigrations: path.join(moduleRoot, "server", "migrations"),
+        sourceEntries: [
+            path.join(repoRoot, "server", "src", "index.ts"),
+            path.join(moduleRoot, "server", "src", "index.ts")
+        ],
+        tsxCliCandidates: [
+            path.join(repoRoot, "node_modules", "tsx", "dist", "cli.mjs"),
+            path.join(moduleRoot, "node_modules", "tsx", "dist", "cli.mjs")
+        ],
+        repoRoot
+    };
+}
+function formatLaunchPlanFailure(moduleRoot) {
+    const paths = buildLaunchPlanSearchPaths(moduleRoot);
+    return [
+        "Forge local runtime could not find a launchable server entry.",
+        `Packaged entry candidates: ${paths.packagedEntries.join(", ")}.`,
+        `Expected migrations at: ${paths.packagedMigrations}.`,
+        `Source entry candidates: ${paths.sourceEntries.join(", ")}.`,
+        `tsx candidates: ${paths.tsxCliCandidates.join(", ")}.`
+    ].join(" ");
+}
 function getRuntimeLogPath(config) {
     const origin = new URL(config.origin).hostname.toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
     return path.join(homedir(), ".openclaw", "logs", FORGE_PLUGIN_ID, `${origin}-${config.port}.log`);
@@ -177,7 +218,7 @@ function openRuntimeLogFile(logPath) {
     return openSync(logPath, "a");
 }
 function isPackagedServerPlan(plan) {
-    return plan.entryFile.endsWith(path.join("dist", "server", "index.js"));
+    return plan.mode === "packaged";
 }
 function getNpmInvocation() {
     const binDir = path.dirname(process.execPath);
@@ -250,23 +291,25 @@ async function ensurePackagedRuntimeDependencies(plan, config) {
 }
 function resolveLaunchPlan() {
     const moduleRoot = getCurrentModuleRoot();
+    const paths = buildLaunchPlanSearchPaths(moduleRoot);
     // Published or linked plugin package runtime.
-    const packagedEntry = path.join(moduleRoot, "dist", "server", "index.js");
-    const packagedMigrations = path.join(moduleRoot, "server", "migrations");
-    if (existsSync(packagedEntry) && existsSync(packagedMigrations)) {
+    const packagedEntry = paths.packagedEntries.find((candidate) => existsSync(candidate));
+    if (packagedEntry && existsSync(paths.packagedMigrations)) {
         return {
             packageRoot: moduleRoot,
-            entryFile: packagedEntry
+            entryFile: packagedEntry,
+            mode: "packaged"
         };
     }
     // Source-tree fallback for local development before packaging.
-    const repoRoot = moduleRoot;
-    const sourceEntry = path.join(repoRoot, "server", "src", "index.ts");
-    const tsxCli = path.join(repoRoot, "node_modules", "tsx", "dist", "cli.mjs");
-    if (existsSync(sourceEntry) && existsSync(tsxCli)) {
+    const sourceEntry = paths.sourceEntries.find((candidate) => existsSync(candidate));
+    const tsxCli = paths.tsxCliCandidates.find((candidate) => existsSync(candidate));
+    if (sourceEntry && tsxCli) {
         return {
-            packageRoot: repoRoot,
-            entryFile: tsxCli
+            packageRoot: paths.repoRoot,
+            entryFile: tsxCli,
+            mode: "source",
+            sourceEntryFile: sourceEntry
         };
     }
     return null;
@@ -330,9 +373,12 @@ async function adoptManagedRuntimeState(config, probe) {
 }
 async function spawnManagedRuntime(config, plan) {
     const isPackagedServer = isPackagedServerPlan(plan);
-    const args = isPackagedServer ? [plan.entryFile] : [plan.entryFile, path.join(plan.packageRoot, "server", "src", "index.ts")];
+    const args = isPackagedServer
+        ? [plan.entryFile]
+        : [plan.entryFile, plan.sourceEntryFile ?? path.join(plan.packageRoot, "server", "src", "index.ts")];
     const logPath = getRuntimeLogPath(config);
     const logFd = openRuntimeLogFile(logPath);
+    const enableManagedDevWeb = shouldEnableManagedDevWeb(plan);
     const child = spawn(process.execPath, args, {
         cwd: plan.packageRoot,
         env: {
@@ -340,6 +386,11 @@ async function spawnManagedRuntime(config, plan) {
             HOST: "127.0.0.1",
             PORT: String(config.port),
             FORGE_BASE_PATH: "/forge/",
+            ...(enableManagedDevWeb
+                ? {
+                    FORGE_DEV_WEB_ORIGIN: process.env.FORGE_DEV_WEB_ORIGIN ?? "http://127.0.0.1:3027/forge/"
+                }
+                : {}),
             ...(config.dataRoot ? { FORGE_DATA_ROOT: config.dataRoot } : {})
         },
         stdio: ["ignore", logFd, logFd],
@@ -454,7 +505,7 @@ export async function ensureForgeRuntimeReady(config) {
     }
     const plan = resolveLaunchPlan();
     if (!plan) {
-        return;
+        throw new Error(formatLaunchPlanFailure(getCurrentModuleRoot()));
     }
     startupPromise = (async () => {
         const probeBeforeStart = await probeForgeRuntime(config, HEALTHCHECK_TIMEOUT_MS);
@@ -556,8 +607,9 @@ export async function startForgeRuntime(config) {
         baseUrl: config.baseUrl
     };
 }
-export function primeForgeRuntime(config) {
-    void ensureForgeRuntimeReady(config).catch(() => {
+export function primeForgeRuntime(config, logger) {
+    void ensureForgeRuntimeReady(config).catch((error) => {
+        logger?.warn?.(`Forge local runtime bootstrap failed for ${config.baseUrl}: ${error instanceof Error ? error.message : String(error)}`);
         // Keep plugin registration non-blocking. Failures surface on first real call.
     });
 }

package/dist/openclaw/plugin-entry-shared.js CHANGED Viewed

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
 import { buildForgeBaseUrl, buildForgeWebAppUrl } from "./api-client.js";
-import { primeForgeRuntime } from "./local-runtime.js";
+import { ensureForgeRuntimeReady, getForgeRuntimeStatus, primeForgeRuntime } from "./local-runtime.js";
 import { registerForgePluginCli, registerForgePluginRoutes } from "./routes.js";
 import { registerForgeSessionBootstrapHook } from "./session-bootstrap.js";
 import { registerForgePluginTools } from "./tools.js";
@@ -175,7 +175,29 @@ export const forgePluginConfigSchema = {
 };
 export function registerForgePlugin(api) {
     const config = resolveForgePluginConfig(api.pluginConfig);
-    primeForgeRuntime(config);
+    if (api.registerService) {
+        api.registerService({
+            id: "forge-local-runtime-bootstrap",
+            start: async ({ logger }) => {
+                if (!isLocalOrigin(config.origin)) {
+                    logger.info?.(`Forge local runtime bootstrap skipped for remote target ${config.baseUrl}.`);
+                    return;
+                }
+                logger.info?.(`Forge local runtime bootstrap: ensuring Forge at ${config.baseUrl}.`);
+                try {
+                    await ensureForgeRuntimeReady(config);
+                    const status = await getForgeRuntimeStatus(config);
+                    logger.info?.(`Forge local runtime bootstrap: ${status?.message ?? `Forge is ready at ${config.baseUrl}.`}`);
+                }
+                catch (error) {
+                    logger.warn?.(`Forge local runtime bootstrap failed for ${config.baseUrl}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        });
+    }
+    else {
+        primeForgeRuntime(config, api.logger);
+    }
     registerForgeSessionBootstrapHook(api, config);
     registerForgePluginRoutes(api, config);
     registerForgePluginCli(api, config);

package/dist/openclaw/plugin-sdk-types.d.ts CHANGED Viewed

@@ -42,6 +42,22 @@ export type ForgeCliRegistrarContext = {
         debug?(message: string): void;
     };
 };
+export type ForgePluginServiceContext = {
+    config?: unknown;
+    workspaceDir?: string;
+    stateDir: string;
+    logger: {
+        info?(message: string): void;
+        warn?(message: string): void;
+        error?(message: string): void;
+        debug?(message: string): void;
+    };
+};
+export type ForgeRegisteredService = {
+    id: string;
+    start: (context: ForgePluginServiceContext) => Promise<void> | void;
+    stop?: (context: ForgePluginServiceContext) => Promise<void> | void;
+};
 export type ForgePluginRegistrationApi = {
     pluginConfig?: unknown;
     logger?: {
@@ -62,6 +78,7 @@ export type ForgePluginRegistrationApi = {
     registerCli?(registrar: (context: ForgeCliRegistrarContext) => void, options?: {
         commands?: string[];
     }): void;
+    registerService?(service: ForgeRegisteredService): void;
 };
 export type ForgePluginRouteApi = Pick<ForgePluginRegistrationApi, "registerHttpRoute">;
 export type ForgePluginToolApi = Pick<ForgePluginRegistrationApi, "registerTool">;

package/dist/openclaw/routes.d.ts CHANGED Viewed

@@ -32,5 +32,32 @@ export declare function buildRouteParityReport(pathMap: Record<string, Record<st
     unexpectedMirrors: `${Uppercase<string>} ${string}`[];
 };
 export declare function registerForgePluginRoutes(api: ForgePluginRouteApi, config: ForgePluginConfig): void;
+export declare function runRouteCheck(config: ForgePluginConfig): Promise<{
+    supported: `${Uppercase<string>} ${string}`[];
+    mirrored: `${Uppercase<string>} ${string}`[];
+    missingFromPlugin: `${Uppercase<string>} ${string}`[];
+    missingFromOpenApi: `${Uppercase<string>} ${string}`[];
+    unexpectedMirrors: `${Uppercase<string>} ${string}`[];
+}>;
+export declare function runDoctor(config: ForgePluginConfig): Promise<{
+    ok: boolean;
+    origin: string;
+    port: number;
+    baseUrl: string;
+    webAppUrl: string;
+    actorLabel: string;
+    apiTokenConfigured: boolean;
+    operatorSessionBootstrapAvailable: boolean;
+    warnings: string[];
+    overview: unknown;
+    onboarding: unknown;
+    routeParity: {
+        supported: `${Uppercase<string>} ${string}`[];
+        mirrored: `${Uppercase<string>} ${string}`[];
+        missingFromPlugin: `${Uppercase<string>} ${string}`[];
+        missingFromOpenApi: `${Uppercase<string>} ${string}`[];
+        unexpectedMirrors: `${Uppercase<string>} ${string}`[];
+    };
+}>;
 export declare function registerForgePluginCli(api: ForgePluginCliApi, config: ForgePluginConfig): void;
 export {};

package/dist/openclaw/routes.js CHANGED Viewed

@@ -681,7 +681,7 @@ async function runReadOnly(config, path) {
         path
     }));
 }
-async function runRouteCheck(config) {
+export async function runRouteCheck(config) {
     const openapi = await runReadOnly(config, "/api/v1/openapi.json");
     const pathMap = typeof openapi === "object" &&
         openapi !== null &&
@@ -692,14 +692,21 @@ async function runRouteCheck(config) {
         : {};
     return buildRouteParityReport(pathMap);
 }
-async function runDoctor(config) {
-    const [health, overview, onboarding, routeParity, uiUrl] = await Promise.all([
-        runReadOnly(config, "/api/v1/health"),
+export async function runDoctor(config) {
+    const [doctorResponse, overview, onboarding, routeParity, uiUrl] = await Promise.all([
+        runReadOnly(config, "/api/v1/doctor"),
         runReadOnly(config, "/api/v1/operator/overview"),
         runReadOnly(config, "/api/v1/agents/onboarding"),
         runRouteCheck(config),
         resolveForgeUiUrl(config)
     ]);
+    const doctorBody = typeof doctorResponse === "object" &&
+        doctorResponse !== null &&
+        "doctor" in doctorResponse &&
+        typeof doctorResponse.doctor === "object" &&
+        doctorResponse.doctor !== null
+        ? doctorResponse.doctor
+        : null;
     const overviewBody = typeof overview === "object" &&
         overview !== null &&
         "overview" in overview &&
@@ -712,10 +719,9 @@ async function runDoctor(config) {
         overviewBody.capabilities !== null
         ? overviewBody.capabilities
         : null;
-    const overviewWarnings = Array.isArray(overviewBody?.warnings)
-        ? overviewBody.warnings.filter((entry) => typeof entry === "string")
+    const warnings = Array.isArray(doctorBody?.warnings)
+        ? doctorBody.warnings.filter((entry) => typeof entry === "string")
         : [];
-    const warnings = [];
     const canBootstrap = canBootstrapOperatorSession(config.baseUrl);
     if (config.apiToken.trim().length === 0 && canBootstrap) {
         warnings.push("Forge apiToken is blank, but this target can bootstrap a local or Tailscale operator session for protected reads and writes.");
@@ -723,9 +729,6 @@ async function runDoctor(config) {
     else if (config.apiToken.trim().length === 0) {
         warnings.push("Forge apiToken is missing, and this target cannot use local or Tailscale operator-session bootstrap. Protected writes will fail.");
     }
-    if (overviewWarnings.length > 0) {
-        warnings.push(...overviewWarnings);
-    }
     if (capabilities && capabilities.canReadPsyche === false) {
         warnings.push("The configured token cannot read Psyche state. Sensitive reflection summaries will stay partial.");
     }
@@ -739,7 +742,9 @@ async function runDoctor(config) {
         warnings.push(`Plugin still mirrors ${routeParity.unexpectedMirrors.length} unexpected route${routeParity.unexpectedMirrors.length === 1 ? "" : "s"} outside the curated contract.`);
     }
     return {
-        ok: (config.apiToken.trim().length > 0 || canBootstrap) &&
+        ...(doctorBody ?? {}),
+        ok: doctorBody?.ok === true &&
+            (config.apiToken.trim().length > 0 || canBootstrap) &&
             routeParity.missingFromPlugin.length === 0 &&
             routeParity.missingFromOpenApi.length === 0 &&
             routeParity.unexpectedMirrors.length === 0,
@@ -751,7 +756,6 @@ async function runDoctor(config) {
         apiTokenConfigured: config.apiToken.trim().length > 0,
         operatorSessionBootstrapAvailable: canBootstrap,
         warnings,
-        health,
         overview,
         onboarding,
         routeParity

package/dist/openclaw/tools.js CHANGED Viewed

@@ -1065,9 +1065,6 @@ export function registerForgePluginTools(api, config) {
             ]),
             label: Type.String({ minLength: 1 }),
             username: optionalString(),
-            clientId: optionalString(),
-            clientSecret: optionalString(),
-            refreshToken: optionalString(),
             password: optionalString(),
             serverUrl: optionalString(),
             authSessionId: optionalString(),