forge-openclaw-plugin 0.2.26 → 0.2.27

package/dist/server/src/lib/workbench/contracts.js

@@ -0,0 +1,229 @@
+import { getWorkbenchEntityPortShape, getWorkbenchModelPortShape, normalizeWorkbenchPortDefinition } from "./nodes.js";
+function toPascalCase(value) {
+    return value
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+export function createOutputDefinition(input) {
+    const inferredEntityShape = input.itemKind
+        ? getWorkbenchEntityPortShape(input.itemKind)
+        : [];
+    const inferredModelShape = input.modelName
+        ? getWorkbenchModelPortShape(input.modelName)
+        : [];
+    return normalizeWorkbenchPortDefinition({
+        key: input.key,
+        label: input.label,
+        kind: input.kind,
+        description: input.description,
+        required: input.required ?? false,
+        modelName: input.modelName,
+        itemKind: input.itemKind,
+        shape: input.shape ??
+            (inferredEntityShape.length > 0 ? inferredEntityShape : inferredModelShape),
+        exampleValue: input.exampleValue
+    });
+}
+export function createInputDefinition(input) {
+    const inferredEntityShape = input.itemKind
+        ? getWorkbenchEntityPortShape(input.itemKind)
+        : [];
+    const inferredModelShape = input.modelName
+        ? getWorkbenchModelPortShape(input.modelName)
+        : [];
+    return normalizeWorkbenchPortDefinition({
+        key: input.key,
+        label: input.label,
+        kind: input.kind,
+        description: input.description,
+        required: input.required ?? false,
+        modelName: input.modelName,
+        itemKind: input.itemKind,
+        shape: input.shape ??
+            (inferredEntityShape.length > 0 ? inferredEntityShape : inferredModelShape),
+        exampleValue: input.exampleValue
+    });
+}
+export function createParamDefinition(input) {
+    return {
+        key: input.key,
+        label: input.label,
+        kind: input.kind,
+        description: input.description,
+        required: input.required ?? false,
+        options: input.options
+    };
+}
+export function createSummaryOutput(input) {
+    return createOutputDefinition({
+        key: "summary",
+        label: input?.label ?? "Summary",
+        kind: "summary",
+        description: input?.description ??
+            "Human-readable summary of what this node currently knows or produced.",
+        modelName: "WorkbenchSummary",
+        exampleValue: input?.exampleValue
+    });
+}
+export function createSearchOutputs(input) {
+    const modelStem = toPascalCase(input.itemKind);
+    return [
+        createSummaryOutput({
+            label: input.summaryLabel ?? "Search summary",
+            description: `Compact summary of the current ${input.itemLabel.toLowerCase()} search results.`
+        }),
+        createOutputDefinition({
+            key: input.collectionKey ?? "matches",
+            label: input.collectionLabel ?? `${input.itemLabel} matches`,
+            kind: "entity_list",
+            description: `Structured ${input.itemLabel.toLowerCase()} records returned by Forge search.`,
+            modelName: `${modelStem}SearchResults`,
+            itemKind: input.itemKind,
+            exampleValue: `[{"id":"...","title":"Example ${input.itemLabel}"}]`
+        }),
+        createOutputDefinition({
+            key: "matchCount",
+            label: "Match count",
+            kind: "number",
+            description: "Number of records returned by the search.",
+            modelName: `${modelStem}SearchCount`,
+            exampleValue: "12"
+        })
+    ];
+}
+export function createSearchInputs(input) {
+    const modelStem = toPascalCase(input.itemKind);
+    return [
+        createInputDefinition({
+            key: "query",
+            label: "Query",
+            kind: "text",
+            description: `Search text for narrowing ${input.itemLabel.toLowerCase()} results.`,
+            modelName: `${modelStem}SearchQuery`,
+            exampleValue: "backlog"
+        }),
+        createInputDefinition({
+            key: "entityTypes",
+            label: "Entity types",
+            kind: "array",
+            description: "Entity types to include in the Forge search.",
+            modelName: `${modelStem}SearchEntityTypes`,
+            exampleValue: JSON.stringify(input.defaultEntityTypes ?? [input.itemKind])
+        }),
+        createInputDefinition({
+            key: "limit",
+            label: "Limit",
+            kind: "number",
+            description: "Maximum number of results to request.",
+            modelName: `${modelStem}SearchLimit`,
+            exampleValue: String(input.defaultLimit ?? 20)
+        })
+    ];
+}
+export function createSearchParams(input) {
+    return [
+        createParamDefinition({
+            key: "query",
+            label: "Default query",
+            kind: "text",
+            description: "Used when no query input edge is connected."
+        }),
+        createParamDefinition({
+            key: "entityTypes",
+            label: "Default entity types",
+            kind: "array",
+            description: "Used when no entity types input edge is connected. Enter a JSON array or comma-separated values."
+        }),
+        createParamDefinition({
+            key: "limit",
+            label: "Default limit",
+            kind: "number",
+            description: "Used when no limit input edge is connected."
+        })
+    ];
+}
+export function createContextOutput(input) {
+    return createOutputDefinition({
+        key: input.key,
+        label: input.label,
+        kind: "context",
+        description: input.description,
+        modelName: input.modelName,
+        shape: input.shape,
+        exampleValue: input.exampleValue
+    });
+}
+export function createRecordListOutput(input) {
+    return createOutputDefinition({
+        key: input.key,
+        label: input.label,
+        kind: "record_list",
+        description: input.description,
+        modelName: input.modelName,
+        itemKind: input.itemKind,
+        exampleValue: input.exampleValue
+    });
+}
+export function createSearchEntitiesTool(description) {
+    return {
+        key: "forge.search_entities",
+        label: "Search Forge entities",
+        description,
+        accessMode: "read",
+        argsSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search text to match against Forge entities." },
+                entityTypes: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional entity types to narrow the search."
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results to return."
+                }
+            }
+        }
+    };
+}
+export function createNoteTool(description) {
+    return {
+        key: "forge.create_note",
+        label: "Create note",
+        description,
+        accessMode: "write",
+        argsSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Title of the note to create." },
+                summary: { type: "string", description: "Optional short summary for the note." },
+                markdown: {
+                    type: "string",
+                    description: "Markdown content that should become the note body."
+                }
+            }
+        }
+    };
+}
+export function createTaskStatusTool(description) {
+    return {
+        key: "forge.update_task_status",
+        label: "Move task",
+        description,
+        accessMode: "write",
+        argsSchema: {
+            type: "object",
+            properties: {
+                taskId: { type: "string", description: "Task id to update." },
+                status: {
+                    type: "string",
+                    description: "New Forge task status.",
+                    enum: ["backlog", "focus", "in_progress", "blocked", "done"]
+                }
+            }
+        }
+    };
+}

package/dist/server/src/lib/workbench/nodes.js

@@ -1,3 +1,203 @@
+export const WORKBENCH_PORT_KINDS = [
+    "text",
+    "number",
+    "boolean",
+    "object",
+    "array",
+    "json",
+    "tool",
+    "summary",
+    "entity",
+    "entity_list",
+    "context",
+    "metrics",
+    "filters",
+    "markdown",
+    "timeline",
+    "selection",
+    "record",
+    "record_list"
+];
+export const LEGACY_WORKBENCH_PORT_KINDS = ["content"];
+const ENTITY_PORT_SHAPES = {
+    goal: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "status", label: "Status", kind: "text" },
+        { key: "horizon", label: "Horizon", kind: "text" }
+    ],
+    project: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "status", label: "Status", kind: "text" },
+        { key: "goalId", label: "Goal id", kind: "text" }
+    ],
+    task: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "status", label: "Status", kind: "text" },
+        { key: "priority", label: "Priority", kind: "text" },
+        { key: "projectId", label: "Project id", kind: "text" }
+    ],
+    strategy: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "status", label: "Status", kind: "text" },
+        { key: "overview", label: "Overview", kind: "markdown" }
+    ],
+    habit: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "status", label: "Status", kind: "text" },
+        { key: "frequency", label: "Frequency", kind: "text" },
+        { key: "polarity", label: "Polarity", kind: "text" }
+    ],
+    note: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "summary", label: "Summary", kind: "markdown" },
+        { key: "kind", label: "Kind", kind: "text" },
+        { key: "updatedAt", label: "Updated at", kind: "text" }
+    ],
+    insight: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "summary", label: "Summary", kind: "markdown" },
+        { key: "status", label: "Status", kind: "text" }
+    ],
+    calendar_event: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "startsAt", label: "Starts at", kind: "text" },
+        { key: "endsAt", label: "Ends at", kind: "text" },
+        { key: "origin", label: "Origin", kind: "text" }
+    ],
+    wiki_page: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "title", label: "Title", kind: "text", required: true },
+        { key: "slug", label: "Slug", kind: "text" },
+        { key: "summary", label: "Summary", kind: "markdown" }
+    ],
+    sleep_session: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "startAt", label: "Start", kind: "text" },
+        { key: "endAt", label: "End", kind: "text" },
+        { key: "totalSleepMinutes", label: "Total sleep minutes", kind: "number" }
+    ],
+    workout_session: [
+        { key: "id", label: "Id", kind: "text", required: true },
+        { key: "type", label: "Type", kind: "text" },
+        { key: "startedAt", label: "Started at", kind: "text" },
+        { key: "durationMinutes", label: "Duration minutes", kind: "number" }
+    ]
+};
+const MODEL_PORT_SHAPES = {
+    WorkbenchUserMessage: [{ key: "message", label: "Message", kind: "text", required: true }],
+    WorkbenchUserContext: [{ key: "context", label: "Context", kind: "record" }],
+    WorkbenchMergedContext: [{ key: "merged", label: "Merged", kind: "record", required: true }],
+    WorkbenchTemplateOutput: [{ key: "rendered", label: "Rendered", kind: "markdown", required: true }],
+    WorkbenchSelectedValue: [{ key: "selected", label: "Selected", kind: "record", required: true }],
+    WorkbenchPublishedOutput: [{ key: "published", label: "Published", kind: "record", required: true }],
+    WeeklyReviewPayload: [
+        { key: "wins", label: "Wins", kind: "record_list" },
+        { key: "trends", label: "Trends", kind: "record_list" }
+    ],
+    InsightsPayload: [
+        { key: "insights", label: "Insights", kind: "record_list" },
+        { key: "heatmap", label: "Heatmap", kind: "record_list" }
+    ],
+    OperatorOverviewPayload: [
+        { key: "summary", label: "Summary", kind: "markdown" },
+        { key: "currentWork", label: "Current work", kind: "record_list" }
+    ],
+    OperatorContextPayload: [
+        { key: "tasks", label: "Tasks", kind: "record_list" },
+        { key: "focus", label: "Focus", kind: "record_list" }
+    ],
+    SleepViewData: [
+        { key: "sessions", label: "Sessions", kind: "record_list" },
+        { key: "metrics", label: "Metrics", kind: "metrics" }
+    ]
+};
+export function inferWorkbenchPortKind(input) {
+    const rawKind = input.kind?.trim().toLowerCase();
+    if (rawKind && WORKBENCH_PORT_KINDS.includes(rawKind)) {
+        return rawKind;
+    }
+    const key = input.key?.trim().toLowerCase() ?? "";
+    const modelName = input.modelName?.trim().toLowerCase() ?? "";
+    if (rawKind === "content") {
+        if (key === "summary" || modelName.includes("summary")) {
+            return "summary";
+        }
+        if (key === "answer" ||
+            key === "rendered" ||
+            modelName.includes("answer") ||
+            modelName.includes("markdown") ||
+            modelName.includes("template")) {
+            return "markdown";
+        }
+        if (key === "message" ||
+            key === "query" ||
+            key === "title" ||
+            modelName.includes("message")) {
+            return "text";
+        }
+        if (input.itemKind) {
+            return "entity_list";
+        }
+        return "record";
+    }
+    if (key.endsWith("count") || key === "limit") {
+        return "number";
+    }
+    if (key === "summary") {
+        return "summary";
+    }
+    if (key === "answer" || key === "rendered") {
+        return "markdown";
+    }
+    if (key === "message" || key === "query") {
+        return "text";
+    }
+    if (input.itemKind) {
+        return "entity_list";
+    }
+    return "record";
+}
+export function normalizeWorkbenchPortKind(input) {
+    return inferWorkbenchPortKind(input);
+}
+export function getWorkbenchEntityPortShape(itemKind) {
+    if (!itemKind) {
+        return [];
+    }
+    return ENTITY_PORT_SHAPES[itemKind] ?? [];
+}
+export function getWorkbenchModelPortShape(modelName) {
+    if (!modelName) {
+        return [];
+    }
+    return MODEL_PORT_SHAPES[modelName] ?? [];
+}
+export function normalizeWorkbenchPortDefinition(port) {
+    const kind = inferWorkbenchPortKind(port);
+    const entityShape = getWorkbenchEntityPortShape(port.itemKind);
+    const modelShape = getWorkbenchModelPortShape(port.modelName);
+    const inferredShape = port.shape && port.shape.length > 0
+        ? port.shape
+        : entityShape.length > 0
+            ? entityShape
+            : modelShape;
+    return {
+        ...port,
+        kind,
+        shape: inferredShape.length > 0 ? inferredShape : []
+    };
+}
+export function normalizeWorkbenchPortDefinitions(ports) {
+    return ports.map((port) => normalizeWorkbenchPortDefinition(port));
+}
 export function defineWorkbenchComponent(component, workbench) {
     return Object.assign(component, {
         workbench: {

package/dist/server/src/lib/workbench/registry.js

@@ -1,22 +1,49 @@
 import { MiniCalendarWidget, QuickCaptureWidget, SpotifyWidget, TimeWidget, WeatherWidget } from "../../components/customization/utility-widgets.js";
+import { InsightsCoachingBox, InsightsFeedBox } from "../../components/workbench-boxes/insights/insights-boxes.js";
 import { KanbanBoardBox, KanbanFiltersBox, KanbanSummaryBox } from "../../components/workbench-boxes/kanban/kanban-boxes.js";
+import { CalendarEventsBox, CalendarOverviewBox, CalendarPlanningBox } from "../../components/workbench-boxes/calendar/calendar-boxes.js";
+import { GoalsHeroBox, GoalsSearchResultsBox, GoalsSummaryBox } from "../../components/workbench-boxes/goals/goals-boxes.js";
+import { HabitsHeroBox, HabitsSearchResultsBox, HabitsSummaryBox } from "../../components/workbench-boxes/habits/habits-boxes.js";
 import { SleepBrowserBox, SleepPatternsBox, SleepSummaryBox, SportsBrowserBox, SportsCompositionBox, SportsSummaryBox } from "../../components/workbench-boxes/health/health-boxes.js";
 import { MovementDataBrowserBox, MovementPlacesBox, MovementSelectionBox, MovementSummaryBox, MovementTimelineBox } from "../../components/workbench-boxes/movement/movement-boxes.js";
 import { NoteComposerBox, NoteFiltersBox, NotesLibraryBox } from "../../components/workbench-boxes/notes/notes-boxes.js";
+import { OverviewInsightsBox, OverviewMomentumBox, OverviewSnapshotBox } from "../../components/workbench-boxes/overview/overview-boxes.js";
 import { ProjectsHeroBox, ProjectsSearchResultsBox, ProjectsSummaryBox } from "../../components/workbench-boxes/projects/projects-boxes.js";
+import { PreferencesContextsBox, PreferencesItemsBox, PreferencesWorkspaceBox } from "../../components/workbench-boxes/preferences/preferences-boxes.js";
+import { PsycheOverviewBox, PsycheReportsBox, PsycheValuesBox } from "../../components/workbench-boxes/psyche/psyche-boxes.js";
+import { QuestionnairesDraftingBox, QuestionnairesLibraryBox, QuestionnairesObservationBox } from "../../components/workbench-boxes/questionnaires/questionnaires-boxes.js";
+import { WeeklyReviewRewardBox, WeeklyReviewSummaryBox } from "../../components/workbench-boxes/review/review-boxes.js";
+import { StrategiesHeroBox, StrategiesSearchResultsBox, StrategiesSummaryBox } from "../../components/workbench-boxes/strategies/strategies-boxes.js";
+import { TasksFocusBox, TasksInboxBox, TasksSummaryBox } from "../../components/workbench-boxes/tasks/tasks-boxes.js";
 import { TodayCalendarBox, TodayFocusBox, TodayHeroBox, TodayMetricsBox, TodayRunwayBox } from "../../components/workbench-boxes/today/today-boxes.js";
+import { WikiAuthoringBox, WikiHealthBox, WikiPagesBox } from "../../components/workbench-boxes/wiki/wiki-boxes.js";
+import { normalizeWorkbenchPortDefinitions } from "./nodes.js";
 export const WORKBENCH_COMPONENT_AUTOLOAD = [
     TimeWidget,
     MiniCalendarWidget,
     SpotifyWidget,
     WeatherWidget,
     QuickCaptureWidget,
+    CalendarOverviewBox,
+    CalendarEventsBox,
+    CalendarPlanningBox,
+    GoalsHeroBox,
+    GoalsSearchResultsBox,
+    GoalsSummaryBox,
+    HabitsHeroBox,
+    HabitsSearchResultsBox,
+    HabitsSummaryBox,
+    InsightsFeedBox,
+    InsightsCoachingBox,
     KanbanSummaryBox,
     KanbanFiltersBox,
     KanbanBoardBox,
     NoteFiltersBox,
     NoteComposerBox,
     NotesLibraryBox,
+    OverviewSnapshotBox,
+    OverviewMomentumBox,
+    OverviewInsightsBox,
     MovementSummaryBox,
     MovementSelectionBox,
     MovementTimelineBox,
@@ -31,11 +58,31 @@ export const WORKBENCH_COMPONENT_AUTOLOAD = [
     ProjectsHeroBox,
     ProjectsSearchResultsBox,
     ProjectsSummaryBox,
+    PreferencesWorkspaceBox,
+    PreferencesContextsBox,
+    PreferencesItemsBox,
+    PsycheOverviewBox,
+    PsycheValuesBox,
+    PsycheReportsBox,
+    QuestionnairesLibraryBox,
+    QuestionnairesDraftingBox,
+    QuestionnairesObservationBox,
+    WeeklyReviewSummaryBox,
+    WeeklyReviewRewardBox,
+    StrategiesHeroBox,
+    StrategiesSearchResultsBox,
+    StrategiesSummaryBox,
+    TasksInboxBox,
+    TasksFocusBox,
+    TasksSummaryBox,
     TodayHeroBox,
     TodayMetricsBox,
     TodayRunwayBox,
     TodayCalendarBox,
-    TodayFocusBox
+    TodayFocusBox,
+    WikiPagesBox,
+    WikiHealthBox,
+    WikiAuthoringBox
 ];
 const REGISTRY = new Map(WORKBENCH_COMPONENT_AUTOLOAD
     .filter((component) => component.workbench)
@@ -62,11 +109,11 @@ export function getWorkbenchNodeCatalog() {
             "content",
             ...(definition.tools.length > 0 ? ["tool"] : [])
         ],
-        inputs: definition.inputs,
-        params: definition.params,
-        output: definition.output,
+        inputs: normalizeWorkbenchPortDefinitions(definition.inputs),
+        params: normalizeWorkbenchPortDefinitions(definition.params),
+        output: normalizeWorkbenchPortDefinitions(definition.output),
         tools: definition.tools,
-        outputs: definition.output,
+        outputs: normalizeWorkbenchPortDefinitions(definition.output),
         toolAdapters: definition.tools,
         snapshotResolverKey: undefined
     }));