forge-openclaw-plugin 0.2.26 → 0.2.28

package/dist/server/server/src/services/entity-crud.js

@@ -1,4 +1,6 @@
+import { z, ZodError } from "zod";
 import { getDatabase, runInTransaction } from "../db.js";
+import { createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getSleepSessionById, getWorkoutSessionById, listSleepSessions, listWorkoutSessions, updateSleepSession, updateSleepSessionSchema, updateWorkoutSession, updateWorkoutSessionSchema } from "../health.js";
 import { createInsight, deleteInsight, getInsightById, listInsights, updateInsight } from "../repositories/collaboration.js";
 import { createCalendarEvent, createTaskTimebox, createWorkBlockTemplate, deleteCalendarEvent, deleteTaskTimebox, deleteWorkBlockTemplate, getCalendarEventById, getTaskTimeboxById, getWorkBlockTemplateById, listCalendarEvents, listTaskTimeboxes, listWorkBlockTemplates, updateCalendarEvent, updateTaskTimebox, updateWorkBlockTemplate } from "../repositories/calendar.js";
 import { createNote, deleteNote, getNoteById, listNotes, unlinkNotesForEntity, updateNote } from "../repositories/notes.js";
@@ -155,6 +157,28 @@ const CRUD_ENTITY_CAPABILITIES = {
         update: (id, patch) => updateTaskTimebox(id, patch),
         hardDelete: (id) => deleteTaskTimebox(id)
     },
+    sleep_session: {
+        entityType: "sleep_session",
+        routeBase: "/api/v1/health/sleep",
+        deleteMode: "immediate",
+        inBin: false,
+        list: () => listSleepSessions(),
+        get: (id) => getSleepSessionById(id),
+        create: (data, context) => createSleepSession(data, context),
+        update: (id, patch, context) => updateSleepSession(id, patch, context),
+        hardDelete: (id, context) => deleteSleepSession(id, context)
+    },
+    workout_session: {
+        entityType: "workout_session",
+        routeBase: "/api/v1/health/workouts",
+        deleteMode: "immediate",
+        inBin: false,
+        list: () => listWorkoutSessions(),
+        get: (id) => getWorkoutSessionById(id),
+        create: (data, context) => createWorkoutSession(data, context),
+        update: (id, patch, context) => updateWorkoutSession(id, patch, context),
+        hardDelete: (id, context) => deleteWorkoutSession(id, context)
+    },
     psyche_value: {
         entityType: "psyche_value",
         routeBase: "/api/v1/psyche/values",
@@ -335,6 +359,8 @@ const CREATE_ENTITY_SCHEMAS = {
     calendar_event: createCalendarEventSchema,
     work_block_template: createWorkBlockTemplateSchema,
     task_timebox: createTaskTimeboxSchema,
+    sleep_session: createSleepSessionSchema,
+    workout_session: createWorkoutSessionSchema,
     psyche_value: createPsycheValueSchema,
     behavior_pattern: createBehaviorPatternSchema,
     behavior: createBehaviorSchema,
@@ -362,6 +388,8 @@ const UPDATE_ENTITY_SCHEMAS = {
     calendar_event: updateCalendarEventSchema,
     work_block_template: updateWorkBlockTemplateSchema,
     task_timebox: updateTaskTimeboxSchema,
+    sleep_session: updateSleepSessionSchema,
+    workout_session: updateWorkoutSessionSchema,
     psyche_value: updatePsycheValueSchema,
     behavior_pattern: updateBehaviorPatternSchema,
     behavior: updateBehaviorSchema,
@@ -377,11 +405,151 @@ const UPDATE_ENTITY_SCHEMAS = {
     preference_item: updatePreferenceItemSchema,
     questionnaire_instrument: updateQuestionnaireInstrumentSchema
 };
+function getCreateSchema(entityType) {
+    return CREATE_ENTITY_SCHEMAS[entityType];
+}
+function getUpdateSchema(entityType) {
+    return UPDATE_ENTITY_SCHEMAS[entityType];
+}
+function unwrapSchema(schema) {
+    if (schema instanceof z.ZodOptional || schema instanceof z.ZodNullable) {
+        return unwrapSchema(schema.unwrap());
+    }
+    if (schema instanceof z.ZodDefault) {
+        return unwrapSchema(schema.removeDefault());
+    }
+    if (schema instanceof z.ZodEffects) {
+        return unwrapSchema(schema.innerType());
+    }
+    return schema;
+}
+function isRequiredField(schema) {
+    if (schema instanceof z.ZodOptional) {
+        return false;
+    }
+    if (schema instanceof z.ZodDefault) {
+        return false;
+    }
+    return true;
+}
+function collectRequiredTopLevelFields(schema) {
+    const unwrapped = unwrapSchema(schema);
+    if (!(unwrapped instanceof z.ZodObject)) {
+        return [];
+    }
+    return Object.entries(unwrapped.shape)
+        .filter(([, fieldSchema]) => isRequiredField(fieldSchema))
+        .map(([key]) => key)
+        .sort();
+}
+function extractAllowedTopLevelFields(schema) {
+    const unwrapped = unwrapSchema(schema);
+    if (!(unwrapped instanceof z.ZodObject)) {
+        return [];
+    }
+    return Object.keys(unwrapped.shape).sort();
+}
+function buildExampleValue(schema) {
+    const unwrapped = unwrapSchema(schema);
+    if (unwrapped instanceof z.ZodString) {
+        return "string";
+    }
+    if (unwrapped instanceof z.ZodNumber) {
+        return 0;
+    }
+    if (unwrapped instanceof z.ZodBoolean) {
+        return false;
+    }
+    if (unwrapped instanceof z.ZodArray) {
+        return [];
+    }
+    if (unwrapped instanceof z.ZodRecord) {
+        return {};
+    }
+    if (unwrapped instanceof z.ZodEnum) {
+        return unwrapped.options[0];
+    }
+    if (unwrapped instanceof z.ZodLiteral) {
+        return unwrapped.value;
+    }
+    if (unwrapped instanceof z.ZodUnion) {
+        return buildExampleValue(unwrapped.options[0] ?? z.string());
+    }
+    if (unwrapped instanceof z.ZodObject) {
+        const objectValue = {};
+        for (const [key, fieldSchema] of Object.entries(unwrapped.shape)) {
+            if (!isRequiredField(fieldSchema)) {
+                continue;
+            }
+            objectValue[key] = buildExampleValue(fieldSchema);
+        }
+        return objectValue;
+    }
+    return "value";
+}
+function buildMinimalExamplePayload(schema) {
+    const unwrapped = unwrapSchema(schema);
+    if (!(unwrapped instanceof z.ZodObject)) {
+        return {};
+    }
+    const requiredFields = collectRequiredTopLevelFields(schema);
+    const example = {};
+    for (const field of requiredFields) {
+        example[field] = buildExampleValue(unwrapped.shape[field]);
+    }
+    return example;
+}
+function formatIssuePath(path) {
+    return path.length > 0 ? path.map(String).join(".") : "body";
+}
+function buildValidationOperationError(input) {
+    const issues = input.error.issues.map((issue) => {
+        const allowedValues = "options" in issue && Array.isArray(issue.options)
+            ? [...issue.options]
+            : undefined;
+        return {
+            path: formatIssuePath(issue.path),
+            message: issue.message,
+            code: issue.code,
+            ...(allowedValues ? { allowedValues } : {})
+        };
+    });
+    const missingRequiredFields = Array.from(new Set(input.error.issues
+        .filter((issue) => issue.code === "invalid_type" &&
+        "received" in issue &&
+        issue.received === "undefined" &&
+        issue.path.length > 0)
+        .map((issue) => formatIssuePath(issue.path)))).sort();
+    const invalidValueGuidance = input.error.issues
+        .filter((issue) => "options" in issue && Array.isArray(issue.options))
+        .map((issue) => ({
+        path: formatIssuePath(issue.path),
+        allowedValues: [...(issue.options ?? [])],
+        message: issue.message
+    }));
+    return {
+        code: input.code,
+        message: input.message,
+        operationType: input.operationType,
+        entityType: input.entityType,
+        clientRef: input.clientRef,
+        routeHint: `/api/v1/entities/${input.operationType}`,
+        toolHint: input.operationType === "search"
+            ? "forge_search_entities"
+            : `forge_${input.operationType}_entities`,
+        summary: `${input.entityType} ${input.operationType} payload failed validation.`,
+        issues,
+        missingRequiredFields,
+        invalidValueGuidance,
+        allowedTopLevelFields: extractAllowedTopLevelFields(input.schema),
+        minimalExamplePayload: buildMinimalExamplePayload(input.schema)
+    };
+}
 function parseCreateInput(entityType, data) {
-    return CREATE_ENTITY_SCHEMAS[entityType].parse(data);
+    return getCreateSchema(entityType).parse(data);
 }
 function parseUpdatePatch(entityType, patch) {
-    return UPDATE_ENTITY_SCHEMAS[entityType].parse(patch);
+    return getUpdateSchema(entityType).parse(patch);
 }
 function toOperationError(code, message) {
     return {
@@ -506,6 +674,8 @@ function matchesLinkedTo(entityType, entity, linkedTo) {
         case "insight":
             return entity.entityType === linkedTo.entityType && entity.entityId === linkedTo.id;
         case "calendar_event":
+        case "sleep_session":
+        case "workout_session":
             return (Array.isArray(entity.links) &&
                 entity.links.some((link) => typeof link === "object" &&
                     link !== null &&
@@ -654,6 +824,22 @@ export function createEntities(input, context) {
             return { ok: true, entityType: entry.entityType, clientRef: entry.clientRef, id: String(entity.id ?? ""), entity };
         }
         catch (error) {
+            if (error instanceof ZodError) {
+                return {
+                    ok: false,
+                    entityType: entry.entityType,
+                    clientRef: entry.clientRef,
+                    error: buildValidationOperationError({
+                        code: "validation_failed",
+                        message: "Entity create payload validation failed.",
+                        operationType: "create",
+                        entityType: entry.entityType,
+                        clientRef: entry.clientRef,
+                        schema: getCreateSchema(entry.entityType),
+                        error
+                    })
+                };
+            }
             return {
                 ok: false,
                 entityType: entry.entityType,
@@ -679,6 +865,23 @@ export function updateEntities(input, context) {
             return { ok: true, entityType: entry.entityType, id: entry.id, clientRef: entry.clientRef, entity };
         }
         catch (error) {
+            if (error instanceof ZodError) {
+                return {
+                    ok: false,
+                    entityType: entry.entityType,
+                    id: entry.id,
+                    clientRef: entry.clientRef,
+                    error: buildValidationOperationError({
+                        code: "validation_failed",
+                        message: "Entity update payload validation failed.",
+                        operationType: "update",
+                        entityType: entry.entityType,
+                        clientRef: entry.clientRef,
+                        schema: getUpdateSchema(entry.entityType),
+                        error
+                    })
+                };
+            }
             return {
                 ok: false,
                 entityType: entry.entityType,