forge-openclaw-plugin 0.2.26 → 0.2.28

package/dist/server/src/components/workbench-boxes/today/today-boxes.js

@@ -1,11 +1,14 @@
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { buildSearchWorkbenchExecution, buildStaticWorkbenchExecution } from "../../../lib/workbench/runtime.js";
+import { createSearchEntitiesTool, createSearchInputs, createSearchOutputs, createSearchParams, createSummaryOutput } from "../../../lib/workbench/contracts.js";
 import { createGenericWorkbenchNodeView } from "../shared/generic-node-view.js";
 import { defineWorkbenchBox } from "../shared/define-workbench-box.js";
 function Slot({ children }) {
     return _jsx(_Fragment, { children: children });
 }
-function defineTodayBox(id, title, description, tags, execute, withSearchTool = false) {
+function defineTodayBox(id, title, description, tags, execute, output, tools = [], options) {
+    const inputs = options?.inputs ?? [];
+    const params = options?.params ?? [];
     return defineWorkbenchBox(Slot, {
         id,
         surfaceId: "today",
@@ -15,49 +18,61 @@ function defineTodayBox(id, title, description, tags, execute, withSearchTool =
         description,
         category: "Today",
         tags,
-        inputs: [],
-        params: [],
-        output: [{ key: "primary", label: title, kind: "content" }],
-        tools: withSearchTool
-            ? [
-                {
-                    key: "forge.search_entities",
-                    label: "Search Forge entities",
-                    description: "Search Forge entities by query and entity types.",
-                    accessMode: "read"
-                }
-            ]
-            : [],
+        inputs,
+        params,
+        output,
+        tools,
         NodeView: createGenericWorkbenchNodeView({
             title,
             description,
-            inputs: [],
-            params: [],
-            output: [{ key: "primary", label: title, kind: "content" }],
-            tools: withSearchTool
-                ? [
-                    {
-                        key: "forge.search_entities",
-                        label: "Search Forge entities",
-                        description: "Search Forge entities by query and entity types.",
-                        accessMode: "read"
-                    }
-                ]
-                : []
+            inputs,
+            params,
+            output,
+            tools
         }),
         execute
     });
 }
-export const TodayHeroBox = defineTodayBox("surface:today:hero", "Today hero", "Daily execution header and directive.", ["today", "hero"], (input) => buildStaticWorkbenchExecution(input, null, "Daily execution header."));
-export const TodayMetricsBox = defineTodayBox("surface:today:metrics", "Live metrics", "Daily XP, level, and momentum metrics.", ["today", "metrics"], (input) => buildStaticWorkbenchExecution(input, null, "Daily metrics."));
+export const TodayHeroBox = defineTodayBox("surface:today:hero", "Today hero", "Daily execution header and directive.", ["today", "hero"], (input) => buildStaticWorkbenchExecution(input, null, "Daily execution header."), [createSummaryOutput({ label: "Today summary", description: "High-level framing for today's execution." })]);
+export const TodayMetricsBox = defineTodayBox("surface:today:metrics", "Live metrics", "Daily XP, level, and momentum metrics.", ["today", "metrics"], (input) => buildStaticWorkbenchExecution(input, null, "Daily metrics."), [createSummaryOutput({ label: "Metrics summary", description: "Summary of today's XP, level, and momentum metrics." })]);
 export const TodayRunwayBox = defineTodayBox("surface:today:runway", "Runway", "Execution lane and current work.", ["today", "execution"], (input) => buildSearchWorkbenchExecution(input, {
     query: "",
     entityTypes: ["task", "habit"],
     limit: 16
-}), true);
-export const TodayCalendarBox = defineTodayBox("surface:today:calendar", "Calendar", "Calendar context for today.", ["today", "calendar"], (input) => buildStaticWorkbenchExecution(input, null, "Today's calendar context."));
+}), createSearchOutputs({
+    itemKind: "execution_item",
+    itemLabel: "Execution item"
+}), [createSearchEntitiesTool("Search today's active tasks and habits by query and entity types.")], {
+    inputs: createSearchInputs({
+        itemKind: "execution_item",
+        itemLabel: "Execution item",
+        defaultEntityTypes: ["task", "habit"],
+        defaultLimit: 16
+    }),
+    params: createSearchParams({
+        itemKind: "execution_item",
+        defaultEntityTypes: ["task", "habit"],
+        defaultLimit: 16
+    })
+});
+export const TodayCalendarBox = defineTodayBox("surface:today:calendar", "Calendar", "Calendar context for today.", ["today", "calendar"], (input) => buildStaticWorkbenchExecution(input, null, "Today's calendar context."), [createSummaryOutput({ label: "Calendar summary", description: "Summary of today's calendar context." })]);
 export const TodayFocusBox = defineTodayBox("surface:today:focus", "Current focus", "Today priorities and focus context.", ["today", "focus"], (input) => buildSearchWorkbenchExecution(input, {
     query: "",
     entityTypes: ["task", "habit"],
     limit: 16
-}), true);
+}), createSearchOutputs({
+    itemKind: "focus_item",
+    itemLabel: "Focus item"
+}), [createSearchEntitiesTool("Search today's priority tasks and habits by query and entity types.")], {
+    inputs: createSearchInputs({
+        itemKind: "focus_item",
+        itemLabel: "Focus item",
+        defaultEntityTypes: ["task", "habit"],
+        defaultLimit: 16
+    }),
+    params: createSearchParams({
+        itemKind: "focus_item",
+        defaultEntityTypes: ["task", "habit"],
+        defaultLimit: 16
+    })
+});

package/dist/server/src/components/workbench-boxes/wiki/wiki-boxes.js

@@ -0,0 +1,60 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { buildStaticWorkbenchExecution, buildWikiHealthWorkbenchExecution, buildWikiPagesWorkbenchExecution } from "../../../lib/workbench/runtime.js";
+import { createContextOutput, createRecordListOutput, createSummaryOutput } from "../../../lib/workbench/contracts.js";
+import { createGenericWorkbenchNodeView } from "../shared/generic-node-view.js";
+import { defineWorkbenchBox } from "../shared/define-workbench-box.js";
+function Slot({ children }) {
+    return _jsx(_Fragment, { children: children });
+}
+function defineWikiBox(id, title, description, tags, execute, output) {
+    return defineWorkbenchBox(Slot, {
+        id,
+        surfaceId: "wiki",
+        routePath: "/wiki",
+        title,
+        icon: "wiki",
+        description,
+        category: "Wiki",
+        tags,
+        inputs: [],
+        params: [],
+        output,
+        tools: [],
+        NodeView: createGenericWorkbenchNodeView({
+            title,
+            description,
+            inputs: [],
+            params: [],
+            output,
+            tools: []
+        }),
+        execute
+    });
+}
+export const WikiPagesBox = defineWikiBox("surface:wiki:pages", "Wiki pages", "Live list of wiki pages that can be used as memory or authored knowledge.", ["wiki", "pages"], (input) => buildWikiPagesWorkbenchExecution(input), [
+    createSummaryOutput({ label: "Wiki page summary", description: "Summary of the currently available wiki pages." }),
+    createRecordListOutput({
+        key: "pages",
+        label: "Wiki pages",
+        description: "Structured wiki page records available in Forge memory.",
+        modelName: "ForgeWikiPages",
+        itemKind: "wiki_page"
+    })
+]);
+export const WikiHealthBox = defineWikiBox("surface:wiki:health", "Wiki health", "Index health, unresolved links, and orphaned-page signals for the wiki.", ["wiki", "health"], (input) => buildWikiHealthWorkbenchExecution(input), [
+    createSummaryOutput({ label: "Wiki health summary", description: "Summary of unresolved links and orphaned-page signals." }),
+    createContextOutput({
+        key: "health",
+        label: "Wiki health",
+        description: "Structured wiki health payload returned by Forge.",
+        modelName: "ForgeWikiHealth"
+    })
+]);
+export const WikiAuthoringBox = defineWikiBox("surface:wiki:authoring", "Wiki authoring", "Authoring and ingest surface for creating or refining Forge memory.", ["wiki", "authoring", "ingest"], (input) => buildStaticWorkbenchExecution(input, {
+    actions: ["upsert", "ingest", "reindex"]
+}, "Wiki authoring surface for ingesting sources and maintaining memory pages."), [
+    createSummaryOutput({
+        label: "Wiki authoring summary",
+        description: "Summary of wiki authoring and ingest actions available on this surface."
+    })
+]);

package/dist/server/src/lib/api.js

@@ -135,6 +135,43 @@ async function request(path, init) {
     }
     return body;
 }
+async function requestBlob(path, init) {
+    const headers = new Headers(init?.headers);
+    headers.set("x-forge-source", "ui");
+    const response = await fetch(resolveForgePath(path), {
+        credentials: "same-origin",
+        headers,
+        ...init
+    });
+    if (!response.ok) {
+        const body = await parseResponseBody(response);
+        const maybeBody = typeof body === "object" && body !== null
+            ? body
+            : null;
+        throw new ForgeApiError({
+            status: response.status,
+            code: typeof maybeBody?.code === "string"
+                ? maybeBody.code
+                : typeof maybeBody?.error === "string"
+                    ? maybeBody.error
+                    : "request_failed",
+            message: typeof maybeBody?.error === "string"
+                ? maybeBody.error
+                : typeof maybeBody?.message === "string"
+                    ? maybeBody.message
+                    : `Request failed: ${response.status}`,
+            requestPath: path,
+            details: []
+        });
+    }
+    const disposition = response.headers.get("content-disposition");
+    const fileNameMatch = disposition?.match(/filename=\"([^\"]+)\"/i);
+    return {
+        blob: await response.blob(),
+        fileName: fileNameMatch?.[1] ?? null,
+        mimeType: response.headers.get("content-type") || "application/octet-stream"
+    };
+}
 function normalizeNestedNotes(notes) {
     return notes
         .map((note) => ({
@@ -195,6 +232,79 @@ export function getForgeSnapshot(userIds) {
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/context${suffix}`).then(normalizeForgeSnapshot);
 }
+export function getLifeForce(userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/life-force${suffix}`);
+}
+export function patchLifeForceProfile(patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/life-force/profile${suffix}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
+export function updateLifeForceTemplate(weekday, input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/life-force/templates/${weekday}${suffix}`, {
+        method: "PUT",
+        body: JSON.stringify(input)
+    });
+}
+export function createFatigueSignal(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/life-force/fatigue-signals${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function getKnowledgeGraph(userIds, query) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    if (query?.q?.trim()) {
+        search.set("q", query.q.trim());
+    }
+    for (const kind of query?.entityKinds ?? []) {
+        search.append("entityKind", kind);
+    }
+    for (const relationKind of query?.relationKinds ?? []) {
+        search.append("relationKind", relationKind);
+    }
+    for (const tag of query?.tags ?? []) {
+        search.append("tag", tag);
+    }
+    for (const owner of query?.owners ?? []) {
+        search.append("owner", owner);
+    }
+    if (query?.updatedFrom) {
+        search.set("updatedFrom", query.updatedFrom);
+    }
+    if (query?.updatedTo) {
+        search.set("updatedTo", query.updatedTo);
+    }
+    if (typeof query?.limit === "number" && Number.isFinite(query.limit)) {
+        search.set("limit", String(query.limit));
+    }
+    if (query?.focusNodeId) {
+        search.set("focusNodeId", query.focusNodeId);
+    }
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/knowledge-graph${suffix}`).then((response) => response.graph);
+}
+export function getKnowledgeGraphFocus(entityType, entityId, userIds) {
+    const search = new URLSearchParams();
+    search.set("entityType", entityType);
+    search.set("entityId", entityId);
+    appendUserIds(search, coerceUserIds(userIds));
+    return request(`/api/v1/knowledge-graph/focus?${search.toString()}`).then((response) => response.focus);
+}
 export function getPreferenceWorkspace(query) {
     const search = new URLSearchParams();
     if (query.userId) {
@@ -957,6 +1067,36 @@ export function getPsycheObservationCalendar(input = {}) {
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/psyche/self-observation/calendar${suffix}`);
 }
+export function exportPsycheObservationCalendar(input) {
+    const search = new URLSearchParams();
+    if (input.from) {
+        search.set("from", input.from);
+    }
+    if (input.to) {
+        search.set("to", input.to);
+    }
+    if (input.search?.trim()) {
+        search.set("search", input.search.trim());
+    }
+    if (input.includeObservations !== undefined) {
+        search.set("includeObservations", String(input.includeObservations));
+    }
+    if (input.includeActivity !== undefined) {
+        search.set("includeActivity", String(input.includeActivity));
+    }
+    if (input.onlyHumanOwned !== undefined) {
+        search.set("onlyHumanOwned", String(input.onlyHumanOwned));
+    }
+    for (const tag of input.tags ?? []) {
+        const trimmed = tag.trim();
+        if (trimmed) {
+            search.append("tags", trimmed);
+        }
+    }
+    search.set("format", input.format);
+    appendUserIds(search, coerceUserIds(input.userIds));
+    return requestBlob(`/api/v1/psyche/self-observation/calendar/export?${search.toString()}`);
+}
 export function listCalendarConnections() {
     return request("/api/v1/calendar/connections");
 }
@@ -1136,6 +1276,9 @@ export function listHabits(input = {}) {
     if (input.dueToday) {
         search.set("dueToday", "true");
     }
+    if (input.orderBy) {
+        search.set("orderBy", input.orderBy);
+    }
     if (input.limit) {
         search.set("limit", String(input.limit));
     }
@@ -1348,6 +1491,18 @@ export function getWorkbenchFlowOutput(connectorId) {
 export function getWorkbenchFlowRuns(connectorId) {
     return request(`/api/v1/workbench/flows/${connectorId}/runs`);
 }
+export function getWorkbenchFlowRun(connectorId, runId) {
+    return request(`/api/v1/workbench/flows/${connectorId}/runs/${runId}`);
+}
+export function getWorkbenchFlowRunNodes(connectorId, runId) {
+    return request(`/api/v1/workbench/flows/${connectorId}/runs/${runId}/nodes`);
+}
+export function getWorkbenchFlowRunNode(connectorId, runId, nodeId) {
+    return request(`/api/v1/workbench/flows/${connectorId}/runs/${runId}/nodes/${nodeId}`);
+}
+export function getWorkbenchFlowNodeOutput(connectorId, nodeId) {
+    return request(`/api/v1/workbench/flows/${connectorId}/nodes/${nodeId}/output`);
+}
 export function getCompanionOverview(userIds) {
     const search = new URLSearchParams();
     appendUserIds(search, coerceUserIds(userIds));
@@ -1390,6 +1545,45 @@ export function getMovementAllTime(userIds) {
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/movement/all-time${suffix}`);
 }
+export function getScreenTimeDay(input) {
+    const search = new URLSearchParams();
+    if (input?.date) {
+        search.set("date", input.date);
+    }
+    appendUserIds(search, coerceUserIds(input?.userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/screen-time/day${suffix}`);
+}
+export function getScreenTimeMonth(input) {
+    const search = new URLSearchParams();
+    if (input?.month) {
+        search.set("month", input.month);
+    }
+    appendUserIds(search, coerceUserIds(input?.userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/screen-time/month${suffix}`);
+}
+export function getScreenTimeAllTime(userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/screen-time/all-time${suffix}`);
+}
+export function getScreenTimeSettings(userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/screen-time/settings${suffix}`);
+}
+export function patchScreenTimeSettings(patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/screen-time/settings${suffix}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
 export function getMovementSettings(userIds) {
     const search = new URLSearchParams();
     appendUserIds(search, coerceUserIds(userIds));
@@ -1444,37 +1638,48 @@ export function getMovementTimeline(input) {
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/movement/timeline${suffix}`);
 }
-export function patchMovementStay(stayId, patch) {
-    return request(`/api/v1/movement/stays/${stayId}`, {
-        method: "PATCH",
-        body: JSON.stringify(patch)
+export function createMovementUserBox(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/movement/user-boxes${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
     });
 }
-export function deleteMovementStay(stayId) {
-    return request(`/api/v1/movement/stays/${stayId}`, {
-        method: "DELETE"
+export function preflightMovementUserBox(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/movement/user-boxes/preflight${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
     });
 }
-export function patchMovementTrip(tripId, patch) {
-    return request(`/api/v1/movement/trips/${tripId}`, {
+export function patchMovementUserBox(boxId, patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/movement/user-boxes/${boxId}${suffix}`, {
         method: "PATCH",
         body: JSON.stringify(patch)
     });
 }
-export function deleteMovementTrip(tripId) {
-    return request(`/api/v1/movement/trips/${tripId}`, {
+export function deleteMovementUserBox(boxId, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/movement/user-boxes/${boxId}${suffix}`, {
         method: "DELETE"
     });
 }
-export function patchMovementTripPoint(tripId, pointId, patch) {
-    return request(`/api/v1/movement/trips/${tripId}/points/${pointId}`, {
-        method: "PATCH",
-        body: JSON.stringify(patch)
-    });
-}
-export function deleteMovementTripPoint(tripId, pointId) {
-    return request(`/api/v1/movement/trips/${tripId}/points/${pointId}`, {
-        method: "DELETE"
+export function invalidateAutomaticMovementBox(boxId, input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/movement/automatic-boxes/${boxId}/invalidate${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
     });
 }
 export function getMovementSelectionAggregate(input) {
@@ -1494,6 +1699,12 @@ export function revokeCompanionPairingSession(pairingSessionId) {
         method: "DELETE"
     });
 }
+export function patchCompanionPairingSourceState(pairingSessionId, source, desiredEnabled) {
+    return request(`/api/v1/health/pairing-sessions/${pairingSessionId}/sources/${source}`, {
+        method: "PATCH",
+        body: JSON.stringify({ desiredEnabled })
+    });
+}
 export function revokeAllCompanionPairingSessions(input) {
     return request("/api/v1/health/pairing-sessions/revoke-all", {
         method: "POST",
@@ -1565,6 +1776,42 @@ export function deleteStrategy(strategyId) {
 export function getSettingsBin() {
     return request("/api/v1/settings/bin");
 }
+export function getDataManagementState() {
+    return request("/api/v1/settings/data");
+}
+export function patchDataManagementSettings(input) {
+    return request("/api/v1/settings/data", {
+        method: "PATCH",
+        body: JSON.stringify(input)
+    });
+}
+export function scanDataRecoveryCandidates() {
+    return request("/api/v1/settings/data/scan", {
+        method: "POST",
+        body: JSON.stringify({})
+    });
+}
+export function createRuntimeDataBackup(note = "") {
+    return request("/api/v1/settings/data/backups", {
+        method: "POST",
+        body: JSON.stringify({ note })
+    });
+}
+export function restoreRuntimeDataBackup(backupId, createSafetyBackup = true) {
+    return request(`/api/v1/settings/data/backups/${backupId}/restore`, {
+        method: "POST",
+        body: JSON.stringify({ createSafetyBackup })
+    });
+}
+export function switchRuntimeDataRoot(input) {
+    return request("/api/v1/settings/data/switch-root", {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function downloadDataExport(format) {
+    return requestBlob(`/api/v1/settings/data/export?format=${format}`);
+}
 export function listAgents() {
     return request("/api/v1/agents");
 }
@@ -1771,6 +2018,9 @@ export function createTask(input) {
         goalId: input.goalId || null,
         projectId: input.projectId || null,
         dueDate: input.dueDate || null,
+        plannedDurationSeconds: input.plannedDurationSeconds === undefined
+            ? null
+            : input.plannedDurationSeconds,
         notes: normalizeNestedNotes(input.notes)
     };
     return request("/api/v1/tasks", {
@@ -1785,10 +2035,19 @@ export function patchTask(taskId, patch) {
             ...patch,
             goalId: patch.goalId === "" ? null : patch.goalId,
             projectId: patch.projectId === "" ? null : patch.projectId,
-            dueDate: patch.dueDate === "" ? null : patch.dueDate
+            dueDate: patch.dueDate === "" ? null : patch.dueDate,
+            plannedDurationSeconds: patch.plannedDurationSeconds === undefined
+                ? undefined
+                : patch.plannedDurationSeconds
         })
     });
 }
+export function splitTask(taskId, input) {
+    return request(`/api/v1/tasks/${taskId}/split`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
 export function deleteTask(taskId) {
     return request(`/api/v1/tasks/${taskId}`, {
         method: "DELETE"

package/dist/server/src/lib/data-management-types.js

@@ -0,0 +1 @@
+export {};