npm - forge-openclaw-plugin - Versions diffs - 0.2.42 → 0.2.44 - Mend

forge-openclaw-plugin 0.2.42 → 0.2.44

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

package/README.md +6 -0
package/dist/assets/{board-C3BJqvZu.js → board-CAszQU7Y.js} +2 -2
package/dist/assets/{board-C3BJqvZu.js.map → board-CAszQU7Y.js.map} +1 -1
package/dist/assets/index-DtEvFzXp.css +1 -0
package/dist/assets/index-s24CefIb.js +91 -0
package/dist/assets/index-s24CefIb.js.map +1 -0
package/dist/assets/{motion-Cv9HdOn4.js → motion-CU5aNClV.js} +2 -2
package/dist/assets/{motion-Cv9HdOn4.js.map → motion-CU5aNClV.js.map} +1 -1
package/dist/assets/{table-B1MDOEFp.js → table-CK0KcPYW.js} +2 -2
package/dist/assets/{table-B1MDOEFp.js.map → table-CK0KcPYW.js.map} +1 -1
package/dist/assets/{ui-CQzq3TE5.js → ui-B5MjRjKe.js} +2 -2
package/dist/assets/{ui-CQzq3TE5.js.map → ui-B5MjRjKe.js.map} +1 -1
package/dist/assets/{vendor-DK-mJFy6.js → vendor-D_NZFJze.js} +2 -2
package/dist/assets/{vendor-DK-mJFy6.js.map → vendor-D_NZFJze.js.map} +1 -1
package/dist/index.html +7 -7
package/dist/openclaw/tools.js +42 -10
package/dist/server/server/src/app.js +151 -34
package/dist/server/server/src/health.js +49 -0
package/dist/server/server/src/movement.js +2 -3
package/dist/server/server/src/openapi.js +19 -1
package/dist/server/src/components/ui/info-tooltip.js +1 -1
package/dist/server/src/lib/knowledge-graph.js +2 -2
package/dist/server/src/lib/schemas.js +1 -1
package/openclaw.plugin.json +1 -1
package/package.json +43 -2
package/skills/forge-openclaw/entity_conversation_playbooks.md +23 -4
package/skills/forge-openclaw/psyche_entity_playbooks.md +8 -0
package/dist/assets/index-Dj8vB0vh.css +0 -1
package/dist/assets/index-Fe5y4VWU.js +0 -91
package/dist/assets/index-Fe5y4VWU.js.map +0 -1

package/dist/index.html CHANGED Viewed

@@ -13,14 +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-Fe5y4VWU.js"></script>
-    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-DK-mJFy6.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/board-C3BJqvZu.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/ui-CQzq3TE5.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/motion-Cv9HdOn4.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/table-B1MDOEFp.js">
+    <script type="module" crossorigin src="/forge/assets/index-s24CefIb.js"></script>
+    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-D_NZFJze.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/board-CAszQU7Y.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/ui-B5MjRjKe.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/motion-CU5aNClV.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/table-CK0KcPYW.js">
     <link rel="stylesheet" crossorigin href="/forge/assets/vendor-DT3pnAKJ.css">
-    <link rel="stylesheet" crossorigin href="/forge/assets/index-Dj8vB0vh.css">
+    <link rel="stylesheet" crossorigin href="/forge/assets/index-DtEvFzXp.css">
   </head>
   <body class="bg-canvas text-ink antialiased">
     <div id="root"></div>

package/dist/openclaw/tools.js CHANGED Viewed

@@ -11,6 +11,46 @@ function jsonResult(payload) {
         details: payload
     };
 }
+function normalizeText(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function normalizeOptionalText(value) {
+    const text = normalizeText(value);
+    return text.length > 0 ? text : undefined;
+}
+function normalizeTaskRunStartRequest(params) {
+    const taskId = normalizeText(params.taskId);
+    if (!taskId) {
+        throw new Error("forge_start_task_run requires a non-empty taskId.");
+    }
+    const actor = normalizeText(params.actor);
+    if (!actor) {
+        throw new Error("forge_start_task_run requires a non-empty actor.");
+    }
+    const timerMode = params.timerMode === "planned" ? "planned" : "unlimited";
+    const plannedDurationSeconds = typeof params.plannedDurationSeconds === "number" &&
+        Number.isInteger(params.plannedDurationSeconds)
+        ? params.plannedDurationSeconds
+        : null;
+    if (timerMode === "planned" && plannedDurationSeconds === null) {
+        throw new Error("forge_start_task_run requires plannedDurationSeconds when timerMode is planned.");
+    }
+    return {
+        taskId,
+        body: {
+            actor,
+            timerMode,
+            plannedDurationSeconds: timerMode === "planned" ? plannedDurationSeconds : null,
+            overrideReason: normalizeOptionalText(params.overrideReason),
+            isCurrent: typeof params.isCurrent === "boolean" ? params.isCurrent : undefined,
+            leaseTtlSeconds: typeof params.leaseTtlSeconds === "number" &&
+                Number.isInteger(params.leaseTtlSeconds)
+                ? params.leaseTtlSeconds
+                : undefined,
+            note: normalizeOptionalText(params.note)
+        }
+    };
+}
 async function runRead(config, path) {
     const result = await callConfiguredForgeApi(config, {
         method: "GET",
@@ -954,19 +994,11 @@ export function registerForgePluginTools(api, config) {
             note: Type.Optional(Type.String())
         }),
         async execute(_toolCallId, params) {
-            const typed = params;
+            const typed = normalizeTaskRunStartRequest(params);
             return jsonResult(await runWrite(config, {
                 method: "POST",
                 path: `/api/v1/tasks/${typed.taskId}/runs`,
-                body: {
-                    actor: typed.actor,
-                    timerMode: typed.timerMode,
-                    plannedDurationSeconds: typed.plannedDurationSeconds,
-                    overrideReason: typed.overrideReason,
-                    isCurrent: typed.isCurrent,
-                    leaseTtlSeconds: typed.leaseTtlSeconds,
-                    note: typed.note
-                }
+                body: typed.body
             }));
         }
     });

package/dist/server/server/src/app.js CHANGED Viewed

@@ -61,7 +61,7 @@ import { buildOpenApiDocument } from "./openapi.js";
 import { registerWebRoutes } from "./web.js";
 import { createManagerRuntime } from "./managers/runtime.js";
 import { isManagerError } from "./managers/type-guards.js";
-import { createCompanionPairingSession, createCompanionPairingSessionSchema, createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getCompanionPairingSessionById, getCompanionOverview, getFitnessViewData, getSleepSessionById, getSleepSessionDetailById, getSleepViewData, getVitalsViewData, getWorkoutSessionById, ingestMobileHealthSync, mobileHealthSyncSchema, patchCompanionPairingSourceState, patchCompanionPairingSourceStateSchema, companionSourceKeySchema, requireValidPairing, revokeAllCompanionPairingSessions, revokeAllCompanionPairingSessionsSchema, revokeCompanionPairingSession, updateMobileCompanionSourceState, updateMobileCompanionSourceStateSchema, verifyCompanionPairing, verifyCompanionPairingSchema, updateSleepMetadata, updateSleepMetadataSchema, updateWorkoutMetadata, updateWorkoutMetadataSchema } from "./health.js";
+import { createCompanionPairingSession, createCompanionPairingSessionSchema, createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getCompanionPairingSessionById, getCompanionOverview, getFitnessViewData, getSleepSessionById, getSleepSessionDetailById, getSleepTimelineOverlaysForRange, getSleepViewData, getVitalsViewData, getWorkoutSessionById, ingestMobileHealthSync, mobileHealthSyncSchema, patchCompanionPairingSourceState, patchCompanionPairingSourceStateSchema, companionSourceKeySchema, requireValidPairing, revokeAllCompanionPairingSessions, revokeAllCompanionPairingSessionsSchema, revokeCompanionPairingSession, updateMobileCompanionSourceState, updateMobileCompanionSourceStateSchema, verifyCompanionPairing, verifyCompanionPairingSchema, updateSleepMetadata, updateSleepMetadataSchema, updateWorkoutMetadata, updateWorkoutMetadataSchema } from "./health.js";
 import { analyzeMovementUserBoxPreflight, createMovementUserBox, createMovementPlace, deleteMovementUserBox, getMovementAllTimeSummary, getMovementBoxDetail, getMovementDayDetail, getMovementMobileBootstrap, getMovementTimeline, getMovementSelectionAggregate, getMovementSettings, getMovementTripDetail, getMovementMonthSummary, invalidateAutomaticMovementBox, listMovementPlaces, movementAutomaticBoxInvalidateSchema, movementMobileBootstrapSchema, movementMobilePlaceMutationSchema, movementMobileStayPatchSchema, movementMobileUserBoxCreateSchema, movementMobileUserBoxPreflightSchema, movementMobileUserBoxPatchSchema, movementMobileAutomaticBoxInvalidateSchema, movementMobileTimelineSchema, movementPlaceMutationSchema, movementPlacePatchSchema, movementSelectionAggregateSchema, movementStayPatchSchema, movementTripPatchSchema, movementUserBoxCreateSchema, movementUserBoxPreflightSchema, movementUserBoxPatchSchema, movementSettingsPatchSchema, movementTimelineQuerySchema, movementTripPointPatchSchema, deleteMovementStay, deleteMovementTrip, deleteMovementTripPoint, updateMovementPlace, updateMovementSettings, updateMovementStay, updateMovementTrip, updateMovementUserBox, updateMovementTripPoint, resolveMovementTimelineSegmentForBox } from "./movement.js";
 import { getScreenTimeAllTimeSummary, getScreenTimeDayDetail, getScreenTimeMonthSummary, getScreenTimeSettings, screenTimeSettingsPatchSchema, updateScreenTimeSettings } from "./screen-time.js";
 import { assertWatchReady, buildWatchBootstrap, ingestWatchCaptureBatch, mobileWatchBootstrapSchema, mobileWatchCaptureBatchSchema, mobileWatchHabitCheckInSchema } from "./watch-mobile.js";
@@ -1980,6 +1980,29 @@ function buildPreferredMutationPath(entityType) {
             return "Read-only surface.";
     }
 }
+function buildPreferredMutationTool(entityType) {
+    if (entityType in AGENT_ONBOARDING_BATCH_ROUTE_BASES) {
+        return "forge_create_entities | forge_update_entities | forge_delete_entities | forge_search_entities";
+    }
+    switch (entityType) {
+        case "wiki_page":
+            return "forge_upsert_wiki_page";
+        case "calendar_connection":
+            return "forge_connect_calendar_provider | forge_sync_calendar_connection";
+        case "task_run":
+            return "forge_start_task_run | forge_heartbeat_task_run | forge_focus_task_run | forge_complete_task_run | forge_release_task_run";
+        case "questionnaire_run":
+            return "forge_start_questionnaire_run | forge_update_questionnaire_run | forge_complete_questionnaire_run";
+        case "preference_judgment":
+            return "forge_submit_preferences_judgment";
+        case "preference_signal":
+            return "forge_submit_preferences_signal";
+        case "work_adjustment":
+            return "forge_adjust_work_minutes";
+        default:
+            return null;
+    }
+}
 function buildPreferredReadPath(entityType) {
     if (entityType in AGENT_ONBOARDING_BATCH_ROUTE_BASES) {
         return AGENT_ONBOARDING_BATCH_ROUTE_BASES[entityType];
@@ -2024,11 +2047,10 @@ function enrichOnboardingEntityGuide(entry) {
             : null,
         preferredMutationPath: buildPreferredMutationPath(entry.entityType),
         preferredReadPath: buildPreferredReadPath(entry.entityType),
-        preferredMutationTool: classification === "batch_crud_entity"
-            ? "forge_create_entities | forge_update_entities | forge_delete_entities | forge_search_entities"
-            : classification === "specialized_domain_surface"
+        preferredMutationTool: buildPreferredMutationTool(entry.entityType) ??
+            (classification === "specialized_domain_surface"
                 ? "Follow forge_get_agent_onboarding.entityRouteModel.specializedDomainSurfaces for the dedicated route family."
-                : null
+                : null)
     };
 }
 const AGENT_ONBOARDING_ENTITY_CATALOG = [
@@ -2758,7 +2780,8 @@ const AGENT_ONBOARDING_CONVERSATION_RULES = [
     "For specialized surfaces, ask what would make the answer or change useful before you ask route-shaped details such as provider, weekday, flow id, run id, or trip id.",
     "When the user already named a precise correction or review target, do not widen back out into a meta lane question. Confirm only the missing route-selecting detail and then act.",
     "Once the route family is clear, say it plainly enough that another agent could follow the same path without guessing.",
-    "For Movement specifically, treat missing-data corrections as user-defined overlay boxes unless the user is editing an already-recorded stay or trip. When the user already gave a clear instruction like 'that missing block was home', act after only the last ambiguity is resolved."
+    "For Movement specifically, treat missing-data corrections as user-defined overlay boxes unless the user is editing an already-recorded stay or trip. When the user already gave a clear instruction like 'that missing block was home', act after only the last ambiguity is resolved.",
+    "For meaning-bearing updates, especially in Psyche, briefly say what feels newly true before you ask for the one structural detail that still changes the save."
 ];
 const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
     {
@@ -2917,7 +2940,8 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Confirm the task.",
             "Confirm the actor only if it is not already obvious.",
             "Ask whether the run should be planned or unlimited only if that changes the action.",
-            "Start the run instead of turning it into a longer intake."
+            "Start the run instead of turning it into a longer intake.",
+            "Use the dedicated task-run tool for start, heartbeat, focus, complete, and release work instead of bouncing to the UI or a generic web route."
         ]
     },
     {
@@ -3071,6 +3095,7 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask whether the focus is a stay, a trip, a place, a timeline window, or a selected span.",
             "Ask for the time window, place, or movement item that makes the question concrete.",
             "Ask what they are trying to notice, preserve, or answer through that movement context.",
+            "Choose the dedicated day, month, all-time, timeline, places, trip-detail, or selection route once the question shape is clear.",
             "Skip the meta lane question when the user already named the exact correction or review target and only one ambiguity remains.",
             "If the request is filling a missing-data gap, use a user-defined movement box rather than a raw stay or trip patch.",
             "If the request is repairing already-saved movement data, use the repair route that matches the saved object instead of treating it like a missing span.",
@@ -3104,6 +3129,7 @@ const AGENT_ONBOARDING_ENTITY_CONVERSATION_PLAYBOOKS = [
             "Ask whether they need the flow contract, a run result, a published output, or a node result.",
             "Ask what the user is trying to learn, repair, or publish through that flow.",
             "If the user already named the flow and action clearly, skip the meta lane question and ask only for the missing run, node, or output scope.",
+            "If the user wants a stable public input contract or published output, prefer those dedicated reads instead of detouring through run history first.",
             "If the user is still shaping a payload or edit, prefer flow detail or box catalog reads before asking for structured inputs.",
             "Prefer flow detail or published-output reads for stable contracts, and use run or node-result routes only when the user is asking about execution history or debugging.",
             "Route to the dedicated workbench route family once the execution lane is clear."
@@ -3853,6 +3879,61 @@ const AGENT_ONBOARDING_TOOL_INPUT_CATALOG = [
         example: '{"taskRunId":"run_123","actor":"aurel","note":"Stopping for now; blocked on feedback","closeoutNote":{"contentMarkdown":"Blocked on feedback from design before I can continue."}}'
     }
 ];
+const VALIDATION_ROUTE_TOOL_MAP = {
+    "POST /api/v1/entities/search": "forge_search_entities",
+    "POST /api/v1/entities/create": "forge_create_entities",
+    "POST /api/v1/entities/update": "forge_update_entities",
+    "POST /api/v1/entities/delete": "forge_delete_entities",
+    "POST /api/v1/entities/restore": "forge_restore_entities",
+    "POST /api/v1/tasks/:id/runs": "forge_start_task_run",
+    "POST /api/v1/task-runs/:id/heartbeat": "forge_heartbeat_task_run",
+    "POST /api/v1/task-runs/:id/focus": "forge_focus_task_run",
+    "POST /api/v1/task-runs/:id/complete": "forge_complete_task_run",
+    "POST /api/v1/task-runs/:id/release": "forge_release_task_run",
+    "POST /api/tasks/:id/runs": "forge_start_task_run",
+    "POST /api/task-runs/:id/heartbeat": "forge_heartbeat_task_run",
+    "POST /api/task-runs/:id/focus": "forge_focus_task_run",
+    "POST /api/task-runs/:id/complete": "forge_complete_task_run",
+    "POST /api/task-runs/:id/release": "forge_release_task_run"
+};
+function formatValidationSummary(issues) {
+    return issues
+        .slice(0, 3)
+        .map((issue) => `${issue.path}: ${issue.message}`)
+        .join("; ");
+}
+function buildValidationHelp(method, routeUrl, issues) {
+    const route = routeUrl || "unknown_route";
+    const toolName = VALIDATION_ROUTE_TOOL_MAP[`${method.toUpperCase()} ${route}`];
+    const toolInput = toolName
+        ? AGENT_ONBOARDING_TOOL_INPUT_CATALOG.find((entry) => entry.toolName === toolName)
+        : undefined;
+    return {
+        route,
+        validationSummary: formatValidationSummary(issues),
+        ...(toolInput
+            ? {
+                expectedShape: {
+                    toolName: toolInput.toolName,
+                    inputShape: toolInput.inputShape,
+                    requiredFields: [...toolInput.requiredFields],
+                    example: toolInput.example,
+                    notes: [...toolInput.notes]
+                }
+            }
+            : {
+                expectedShape: {
+                    inputShape: "See details[] for the rejected fields on this route.",
+                    requiredFields: [],
+                    example: null,
+                    notes: [
+                        "Retry with only the documented top-level keys for this route.",
+                        "Omit optional fields instead of sending null unless the route contract explicitly allows null."
+                    ]
+                }
+            })
+    };
+}
 function buildAgentOnboardingPayload(request) {
     const origin = getRequestOrigin(request);
     return {
@@ -4198,10 +4279,12 @@ function buildAgentOnboardingPayload(request) {
                 verifyCommands: [
                     `curl -s ${origin}/api/v1/health`,
                     "openclaw plugins install ./projects/forge/openclaw-plugin",
+                    "openclaw plugins info forge-openclaw-plugin",
                     "openclaw gateway restart"
                 ],
                 configNotes: [
                     "Localhost and Tailscale targets can usually use the operator-session path without a long-lived token.",
+                    "If your current OpenClaw build blocks the repo-local install because of the package scanner, keep the repo folder on plugins.load.paths and verify that plugins info still points at the local Forge source path before continuing.",
                     "Use a distinct actor label such as Albert (claw) so OpenClaw-originated work stays obvious in Forge provenance.",
                     "Create each agent as a Forge bot user, then use userId or userIds in tool inputs whenever the agent should focus on one human, one bot, or a specific collaboration slice."
                 ]
@@ -4558,6 +4641,30 @@ function resolveScopedUserIds(query) {
     const unique = Array.from(new Set(values));
     return unique.length > 0 ? unique : undefined;
 }
+function attachMovementTimelineSleepOverlays(movement, userIds) {
+    const rangeStart = movement.segments.reduce((earliest, segment) => {
+        if (!earliest || Date.parse(segment.startedAt) < Date.parse(earliest)) {
+            return segment.startedAt;
+        }
+        return earliest;
+    }, null);
+    const rangeEnd = movement.segments.reduce((latest, segment) => {
+        if (!latest || Date.parse(segment.endedAt) > Date.parse(latest)) {
+            return segment.endedAt;
+        }
+        return latest;
+    }, null);
+    return {
+        ...movement,
+        sleepOverlays: rangeStart && rangeEnd
+            ? getSleepTimelineOverlaysForRange({
+                startedAt: rangeStart,
+                endedAt: rangeEnd,
+                userIds
+            })
+            : []
+    };
+}
 function readRequestedUserIdFromBody(body) {
     if (!body || typeof body !== "object" || Array.isArray(body)) {
         return undefined;
@@ -4581,13 +4688,17 @@ function syncEntityOwnerFromBody(options) {
     setEntityOwner(options.entityType, options.entityId, owner.id);
 }
 function buildV1Context(userIds) {
-    const goals = filterOwnedEntities("goal", listGoals(), userIds);
-    const tasks = filterOwnedEntities("task", listTasks(), userIds);
-    const habits = filterOwnedEntities("habit", listHabits(), userIds);
     const users = listUsers();
-    const dashboard = getDashboard({ userIds });
-    const selectedUsers = userIds && userIds.length > 0
-        ? users.filter((user) => userIds.includes(user.id))
+    const validUserIdSet = new Set(users.map((user) => user.id));
+    const scopedUserIds = userIds && userIds.length > 0
+        ? userIds.filter((userId) => validUserIdSet.has(userId))
+        : undefined;
+    const goals = filterOwnedEntities("goal", listGoals(), scopedUserIds);
+    const tasks = filterOwnedEntities("task", listTasks(), scopedUserIds);
+    const habits = filterOwnedEntities("habit", listHabits(), scopedUserIds);
+    const dashboard = getDashboard({ userIds: scopedUserIds });
+    const selectedUsers = scopedUserIds && scopedUserIds.length > 0
+        ? users.filter((user) => scopedUserIds.includes(user.id))
         : users;
     return {
         meta: {
@@ -4599,23 +4710,23 @@ function buildV1Context(userIds) {
         },
         metrics: buildGamificationProfile(goals, tasks, habits),
         dashboard,
-        overview: getOverviewContext(new Date(), { userIds }),
-        today: getTodayContext(new Date(), { userIds }),
-        risk: getRiskContext(new Date(), { userIds }),
+        overview: getOverviewContext(new Date(), { userIds: scopedUserIds }),
+        today: getTodayContext(new Date(), { userIds: scopedUserIds }),
+        risk: getRiskContext(new Date(), { userIds: scopedUserIds }),
         goals,
-        projects: listProjectSummaries({ userIds }),
+        projects: listProjectSummaries({ userIds: scopedUserIds }),
         tags: listTags(),
         tasks,
         habits,
         users,
-        strategies: listStrategies({ userIds }),
+        strategies: listStrategies({ userIds: scopedUserIds }),
         userScope: {
-            selectedUserIds: userIds ?? [],
+            selectedUserIds: scopedUserIds ?? [],
             selectedUsers
         },
         activeTaskRuns: listTaskRuns({ active: true, limit: 25 }),
         activity: dashboard.recentActivity,
-        lifeForce: buildLifeForcePayload(new Date(), userIds)
+        lifeForce: buildLifeForcePayload(new Date(), scopedUserIds)
     };
 }
 function buildXpMetricsPayload() {
@@ -5045,6 +5156,10 @@ export async function buildServer(options = {}) {
     });
     app.setErrorHandler((error, request, reply) => {
         const validationIssues = error instanceof ZodError ? formatValidationIssues(error) : undefined;
+        const routeUrl = request.routeOptions.url || request.url;
+        const validationHelp = validationIssues
+            ? buildValidationHelp(request.method, routeUrl, validationIssues)
+            : undefined;
         const statusCode = isHttpError(error)
             ? error.statusCode
             : isManagerError(error)
@@ -5052,7 +5167,6 @@ export async function buildServer(options = {}) {
                 : error instanceof ZodError
                     ? 400
                     : 500;
-        const routeUrl = request.routeOptions.url || request.url;
         if (!shouldSkipAutomaticDiagnosticRoute(routeUrl)) {
             try {
                 recordDiagnosticLog({
@@ -5093,10 +5207,11 @@ export async function buildServer(options = {}) {
                         ? "invalid_request"
                         : "internal_error",
             error: validationIssues
-                ? "Request validation failed"
+                ? `Request validation failed for ${request.method.toUpperCase()} ${routeUrl}. ${validationHelp?.validationSummary ?? ""}`.trim()
                 : getErrorMessage(error),
             statusCode,
             ...(validationIssues ? { details: validationIssues } : {}),
+            ...(validationHelp ?? {}),
             ...(isHttpError(error) && error.details ? error.details : {}),
             ...(isManagerError(error) && error.details ? error.details : {})
         });
@@ -5514,14 +5629,15 @@ export async function buildServer(options = {}) {
     });
     app.get("/api/v1/movement/timeline", async (request) => {
         const parsed = movementTimelineQuerySchema.parse(request.query ?? {});
+        const userIds = parsed.userIds.length > 0
+            ? parsed.userIds
+            : (resolveScopedUserIds(request.query) ?? []);
+        const movement = getMovementTimeline({
+            ...parsed,
+            userIds
+        });
         return {
-            movement: getMovementTimeline({
-                ...parsed,
-                userIds: parsed.userIds.length > 0
-                    ? parsed.userIds
-                    : (resolveScopedUserIds(request.query) ??
-                        [])
-            })
+            movement: attachMovementTimelineSleepOverlays(movement, userIds)
         };
     });
     app.get("/api/v1/movement/settings", async (request) => ({
@@ -5790,12 +5906,13 @@ export async function buildServer(options = {}) {
     app.post("/api/v1/mobile/movement/timeline", async (request) => {
         const parsed = movementMobileTimelineSchema.parse(request.body ?? {});
         const pairing = requireValidPairing(parsed.sessionId, parsed.pairingToken);
+        const movement = getMovementTimeline({
+            before: parsed.before,
+            limit: parsed.limit,
+            userIds: [pairing.user_id]
+        });
         return {
-            movement: getMovementTimeline({
-                before: parsed.before,
-                limit: parsed.limit,
-                userIds: [pairing.user_id]
-            })
+            movement: attachMovementTimelineSleepOverlays(movement, [pairing.user_id])
         };
     });
     app.post("/api/v1/mobile/movement/boxes/:id/detail", async (request, reply) => {

package/dist/server/server/src/health.js CHANGED Viewed

@@ -838,6 +838,55 @@ function listSleepRows(userIds) {
        ORDER BY started_at DESC`)
         .all(...params);
 }
+export function getSleepTimelineOverlaysForRange(input) {
+    const rangeStartMs = Date.parse(input.startedAt);
+    const rangeEndMs = Date.parse(input.endedAt);
+    if (Number.isNaN(rangeStartMs) ||
+        Number.isNaN(rangeEndMs) ||
+        rangeEndMs <= rangeStartMs) {
+        return [];
+    }
+    return listSleepRows(input.userIds)
+        .map((row) => mapSleepSession(row))
+        .filter((session) => {
+        const sessionStartMs = Date.parse(session.startedAt);
+        const sessionEndMs = Date.parse(session.endedAt);
+        if (Number.isNaN(sessionStartMs) || Number.isNaN(sessionEndMs)) {
+            return false;
+        }
+        return sessionStartMs < rangeEndMs && sessionEndMs > rangeStartMs;
+    })
+        .sort((left, right) => {
+        const startedDelta = Date.parse(left.startedAt) - Date.parse(right.startedAt);
+        if (startedDelta !== 0) {
+            return startedDelta;
+        }
+        const endedDelta = Date.parse(left.endedAt) - Date.parse(right.endedAt);
+        if (endedDelta !== 0) {
+            return endedDelta;
+        }
+        return left.id.localeCompare(right.id);
+    })
+        .map((session) => {
+        const derived = session.derived;
+        return {
+            id: session.id,
+            externalUid: session.externalUid,
+            startedAt: session.startedAt,
+            endedAt: session.endedAt,
+            localDateKey: session.localDateKey,
+            sourceTimezone: session.sourceTimezone,
+            asleepSeconds: session.asleepSeconds,
+            timeInBedSeconds: session.timeInBedSeconds,
+            sleepScore: session.sleepScore,
+            regularityScore: session.regularityScore,
+            efficiency: typeof derived?.efficiency === "number" ? derived.efficiency : null,
+            recoveryState: typeof derived?.recoveryState === "string"
+                ? derived.recoveryState
+                : null
+        };
+    });
+}
 function listWorkoutRows(userIds) {
     const params = [];
     const where = userIds && userIds.length > 0

package/dist/server/server/src/movement.js CHANGED Viewed

@@ -2780,10 +2780,9 @@ function updateMovementBoxOverrideState(id, input) {
            overridden_user_box_ids_json = ?,
            override_ranges_json = ?,
            is_overridden = ?,
-           is_fully_hidden = ?,
-           updated_at = ?
+           is_fully_hidden = ?
        WHERE id = ?`)
-        .run(input.overrideCount, JSON.stringify(input.overriddenAutomaticBoxIds), input.trueStartedAt, input.trueEndedAt, input.overriddenStartedAt, input.overriddenEndedAt, input.overriddenByBoxId, JSON.stringify(input.overriddenUserBoxIds), JSON.stringify(input.overrideRanges), input.isOverridden ? 1 : 0, input.isFullyHidden ? 1 : 0, nowIso(), id);
+        .run(input.overrideCount, JSON.stringify(input.overriddenAutomaticBoxIds), input.trueStartedAt, input.trueEndedAt, input.overriddenStartedAt, input.overriddenEndedAt, input.overriddenByBoxId, JSON.stringify(input.overriddenUserBoxIds), JSON.stringify(input.overrideRanges), input.isOverridden ? 1 : 0, input.isFullyHidden ? 1 : 0, id);
 }
 function recomputeMovementBoxOverrideState(userId) {
     const rows = listMovementBoxRows({ userIds: [userId] });

package/dist/server/server/src/openapi.js CHANGED Viewed

@@ -333,6 +333,18 @@ export function buildOpenApiDocument() {
             message: { type: "string" }
         }
     };
+    const validationExpectedShape = {
+        type: "object",
+        additionalProperties: true,
+        required: ["inputShape", "requiredFields", "notes"],
+        properties: {
+            toolName: { type: "string" },
+            inputShape: { type: "string" },
+            requiredFields: arrayOf({ type: "string" }),
+            example: { type: ["string", "null"] },
+            notes: arrayOf({ type: "string" })
+        }
+    };
     const errorResponse = {
         type: "object",
         additionalProperties: true,
@@ -341,7 +353,12 @@ export function buildOpenApiDocument() {
             code: { type: "string" },
             error: { type: "string" },
             statusCode: { type: "integer" },
-            details: arrayOf({ $ref: "#/components/schemas/ValidationIssue" })
+            route: { type: "string" },
+            validationSummary: { type: "string" },
+            details: arrayOf({ $ref: "#/components/schemas/ValidationIssue" }),
+            expectedShape: {
+                $ref: "#/components/schemas/ValidationExpectedShape"
+            }
         }
     };
     const tag = {
@@ -4098,6 +4115,7 @@ export function buildOpenApiDocument() {
         components: {
             schemas: {
                 ValidationIssue: validationIssue,
+                ValidationExpectedShape: validationExpectedShape,
                 ErrorResponse: errorResponse,
                 Tag: tag,
                 Goal: goal,

package/dist/server/src/components/ui/info-tooltip.js CHANGED Viewed

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useId, useRef, useState } from "react";
 import { CircleHelp } from "lucide-react";
-import { cn } from "@/lib/utils";
+import { cn } from "../../lib/utils.js";
 export function FieldHint({ children, className }) {
     return _jsx("div", { className: cn("text-sm leading-6 text-white/50", className), children: children });
 }

package/dist/server/src/lib/knowledge-graph.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { getEntityVisual, isEntityKind } from "@/lib/entity-visuals";
-import { KNOWLEDGE_GRAPH_HIERARCHY_LANES, KNOWLEDGE_GRAPH_HIERARCHY_ORDER, KNOWLEDGE_GRAPH_RELATION_FAMILY_LABELS, KNOWLEDGE_GRAPH_RELATION_LABELS, buildKnowledgeGraphNodeId } from "@/lib/knowledge-graph-types";
+import { getEntityVisual, isEntityKind } from "./entity-visuals.js";
+import { KNOWLEDGE_GRAPH_HIERARCHY_LANES, KNOWLEDGE_GRAPH_HIERARCHY_ORDER, KNOWLEDGE_GRAPH_RELATION_FAMILY_LABELS, KNOWLEDGE_GRAPH_RELATION_LABELS, buildKnowledgeGraphNodeId } from "./knowledge-graph-types.js";
 export function getKnowledgeGraphNodeVisual(node) {
     const kind = isEntityKind(node.entityKind) ? node.entityKind : "note";
     return getEntityVisual(kind);

package/dist/server/src/lib/schemas.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { forgeCustomThemeSchema, forgeThemePreferenceSchema } from "@/lib/theme-system";
+import { forgeCustomThemeSchema, forgeThemePreferenceSchema } from "./theme-system.js";
 export const appLocaleSchema = z.enum(["en", "fr"]);
 export const inlineCreateNoteSchema = z.object({
     contentMarkdown: z.string().trim().min(1, "Note content is required"),

package/openclaw.plugin.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.42",
+  "version": "0.2.44",
   "skills": [
     "./skills"
   ],

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.42",
+  "version": "0.2.44",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "MIT",
@@ -44,17 +44,58 @@
     "openclaw": "2026.4.15"
   },
   "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
     "@azure/msal-node": "^5.1.2",
     "@fastify/cors": "^10.0.1",
     "@fastify/multipart": "^9.4.0",
+    "@fontsource-variable/plus-jakarta-sans": "^5.2.8",
+    "@fontsource-variable/sora": "^5.2.8",
+    "@fontsource/space-grotesk": "^5.2.10",
+    "@hookform/resolvers": "^5.1.1",
+    "@mariozechner/pi-ai": "^0.66.1",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@reduxjs/toolkit": "^2.11.2",
     "@sinclair/typebox": "^0.34.48",
+    "@tanstack/react-query": "^5.80.10",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "^3.13.12",
+    "@tauri-apps/api": "^2.8.0",
+    "@tiptap/react": "^2.15.0",
+    "@tiptap/starter-kit": "^2.15.0",
+    "@types/react-grid-layout": "^1.3.6",
+    "@xyflow/react": "^12.10.2",
     "adm-zip": "^0.5.17",
+    "bonjour-service": "^1.3.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cron-parser": "^5.5.0",
     "fastify": "^5.8.5",
+    "framer-motion": "^12.16.0",
+    "graphology": "^0.26.0",
+    "graphology-layout": "^0.6.1",
+    "graphology-layout-forceatlas2": "^0.10.1",
+    "lucide-react": "^0.525.0",
     "node-ical": "^0.20.1",
+    "qrcode": "^1.5.4",
+    "react": "^19.1.0",
+    "react-arborist": "^3.4.3",
+    "react-dom": "^19.1.0",
+    "react-grid-layout": "^2.2.3",
+    "react-hook-form": "^7.57.0",
+    "react-is": "^19.2.5",
+    "react-redux": "^9.2.0",
+    "react-router-dom": "^7.13.1",
+    "recharts": "^3.1.0",
+    "sigma": "^3.0.2",
+    "tailwind-merge": "^3.3.1",
     "tsdav": "^2.1.8",
-    "zod": "^3.25.67"
+    "zod": "^3.25.67",
+    "zustand": "^5.0.5"
   },
   "overrides": {
+    "basic-ftp": "^5.3.0",
     "axios": "^1.15.0",
     "follow-redirects": "^1.16.0",
     "hono": "4.12.14"