ofiere-openclaw-plugin 4.53.0 → 4.54.1

package/dist/src/tools.js

@@ -6462,6 +6462,436 @@ function registerTalentContextHook(api, supabase, userId, fallbackAgentId) {
     }
 }
 // ═══════════════════════════════════════════════════════════════════════════════
+// META-TOOL 17: OFIERE_OFFICE_OPS — Agent Office Canvas (widget dashboard)
+// ═══════════════════════════════════════════════════════════════════════════════
+async function emitOfficeWebhook(api, type, payload) {
+    const webhookUrl = process.env.OFIERE_DASHBOARD_WEBHOOK_URL || "";
+    const webhookSecret = process.env.OPENCLAW_WEBHOOK_SECRET || "";
+    if (!webhookUrl || !webhookSecret)
+        return;
+    try {
+        await fetch(webhookUrl, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${webhookSecret}`,
+            },
+            body: JSON.stringify({ type, payload }),
+        });
+    }
+    catch (wErr) {
+        api.logger.debug?.(`[ofiere-office] webhook post failed: ${wErr instanceof Error ? wErr.message : String(wErr)}`);
+    }
+}
+function validateSection(s) {
+    if (!s || typeof s !== "object")
+        return "section is not an object";
+    if (typeof s.title !== "string" || !s.title)
+        return "section.title required";
+    if (typeof s.order !== "number")
+        return "section.order must be a number";
+    if (!Array.isArray(s.widgets))
+        return "section.widgets must be an array";
+    for (const w of s.widgets) {
+        const wErr = validateWidget(w);
+        if (wErr)
+            return `section "${s.title}": ${wErr}`;
+    }
+    return null;
+}
+function validateWidget(w) {
+    if (!w || typeof w !== "object")
+        return "widget is not an object";
+    if (typeof w.type !== "string" || !w.type)
+        return "widget.type required";
+    if (typeof w.config !== "object" || w.config === null)
+        return "widget.config must be an object";
+    const ly = w.layout;
+    if (!ly || typeof ly !== "object")
+        return "widget.layout required";
+    if (typeof ly.x !== "number" || typeof ly.y !== "number" || typeof ly.w !== "number" || typeof ly.h !== "number") {
+        return "widget.layout must have numeric x, y, w, h";
+    }
+    return null;
+}
+function shortId(prefix) {
+    return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function registerOfficeOps(api, supabase, userId, resolveAgent) {
+    api.registerTool((toolCtx) => ({
+        name: "OFIERE_OFFICE_OPS",
+        label: "Ofiere Office Operations",
+        description: `Build and update your department Office — a widget-based dashboard canvas bound to a PM Space.\n\n` +
+            `Actions:\n` +
+            `- "get_office": Load the current layout + widget data for a given (space_id, agent_id). Optional: space_id, agent_id.\n` +
+            `- "build_office": One-time initial build. Required: space_id, sections. Only callable while the office row is in 'initializing' state.\n` +
+            `- "update_widgets": Modify the layout (add/remove/replace/patch widgets or sections). Required: office_id, operations. Locked items are skipped (returns warnings).\n` +
+            `- "update_widget_data": Push fresh data for a single widget. Required: office_id, widget_id, data. Always succeeds regardless of lock state — locks protect layout, not data.\n\n` +
+            `Layout shape:\n` +
+            `  { version: 1, sections: [ { id, title, description?, order, locked?, collapsed?, columns, widgets: [ { id, type, config, layout: {x,y,w,h}, locked?, data_source? } ] } ] }\n\n` +
+            `Widget catalog (the dashboard knows which types exist): kpi_card, bar_chart, line_chart, donut_chart, progress_bar, sparkline, heatmap, data_table, activity_feed, report_card, status_list, checklist, text_block, embed, quick_action, file_browser, staff_roster.\n\n` +
+            `Operation shape (RFC-6902 flavored): { op: 'add'|'remove'|'replace'|'patch', path: '/sections/0/widgets/-' or '/sections/0/widgets/0', value?, widget?, config? }`,
+        parameters: {
+            type: "object",
+            required: ["action"],
+            properties: {
+                action: {
+                    type: "string",
+                    description: "get_office, build_office, update_widgets, update_widget_data",
+                },
+                space_id: { type: "string", description: "PM space UUID" },
+                agent_id: { type: "string", description: "Agent identifier (defaults to calling agent)" },
+                office_id: { type: "string", description: "Office row UUID" },
+                widget_id: { type: "string", description: "Widget short id" },
+                sections: { type: "array", description: "Initial layout sections (build_office only)" },
+                operations: { type: "array", description: "Patch operations (update_widgets only)" },
+                data: { type: "object", description: "Widget data payload (update_widget_data only)" },
+            },
+        },
+        async execute(_id, params) {
+            const action = params.action;
+            const ctxAgentHint = toolCtx?.agentAccountId || toolCtx?.agentId || "";
+            async function resolveCallingAgent(explicitId) {
+                if (explicitId && explicitId.trim())
+                    return resolveAgent(explicitId);
+                if (ctxAgentHint)
+                    return resolveAgent(ctxAgentHint);
+                return resolveAgent();
+            }
+            switch (action) {
+                case "get_office": {
+                    const agentId = await resolveCallingAgent(params.agent_id);
+                    if (!agentId)
+                        return err("Could not resolve agent_id");
+                    let q = supabase
+                        .from("agent_office_layouts")
+                        .select("id, space_id, agent_id, status, is_finalized, layout, last_agent_update_at, error_message, updated_at")
+                        .eq("user_id", userId)
+                        .eq("agent_id", agentId);
+                    if (params.space_id)
+                        q = q.eq("space_id", params.space_id);
+                    const { data: rows, error } = await q.limit(1);
+                    if (error)
+                        return err(error.message);
+                    if (!rows || rows.length === 0)
+                        return err("No office found for this agent");
+                    const office = rows[0];
+                    const { data: widgetData } = await supabase
+                        .from("agent_office_data")
+                        .select("widget_id, data, updated_at")
+                        .eq("user_id", userId)
+                        .eq("office_id", office.id);
+                    const dataMap = {};
+                    for (const row of widgetData || []) {
+                        dataMap[row.widget_id] = row.data;
+                    }
+                    return ok({ office, widget_data: dataMap });
+                }
+                case "build_office": {
+                    if (!params.space_id)
+                        return err("Missing required: space_id");
+                    if (!Array.isArray(params.sections))
+                        return err("Missing required: sections (array)");
+                    const agentId = await resolveCallingAgent(params.agent_id);
+                    if (!agentId)
+                        return err("Could not resolve agent_id");
+                    const inputSections = params.sections;
+                    for (let i = 0; i < inputSections.length; i++) {
+                        const sErr = validateSection(inputSections[i]);
+                        if (sErr)
+                            return err(`Validation failed at section[${i}]: ${sErr}`);
+                    }
+                    const { data: existing, error: loadErr } = await supabase
+                        .from("agent_office_layouts")
+                        .select("id, status")
+                        .eq("user_id", userId)
+                        .eq("space_id", params.space_id)
+                        .eq("agent_id", agentId)
+                        .maybeSingle();
+                    if (loadErr)
+                        return err(`Office lookup failed: ${loadErr.message}`);
+                    if (!existing)
+                        return err("Office row not found — dashboard must call /api/office/initialize first");
+                    if (existing.status !== "initializing") {
+                        return err(`Office already built (status=${existing.status}). Use update_widgets to modify.`);
+                    }
+                    const normalized = inputSections.map((s, idx) => {
+                        const widgets = (s.widgets || []).map((w) => ({
+                            id: typeof w.id === "string" && w.id ? w.id : shortId("wgt"),
+                            type: w.type,
+                            config: w.config || {},
+                            layout: {
+                                x: w.layout.x,
+                                y: w.layout.y,
+                                w: w.layout.w,
+                                h: w.layout.h,
+                                minW: w.layout.minW,
+                                minH: w.layout.minH,
+                                maxW: w.layout.maxW,
+                                maxH: w.layout.maxH,
+                            },
+                            locked: w.locked === true,
+                            data_source: w.data_source || { type: "agent", refresh_interval: 3600, last_refreshed_at: null },
+                        }));
+                        return {
+                            id: typeof s.id === "string" && s.id ? s.id : shortId("sec"),
+                            title: s.title,
+                            description: s.description,
+                            order: typeof s.order === "number" ? s.order : idx,
+                            locked: s.locked === true,
+                            collapsed: s.collapsed === true,
+                            columns: typeof s.columns === "number" ? s.columns : 3,
+                            widgets,
+                        };
+                    });
+                    const layout = { version: 1, sections: normalized };
+                    const { error: updateErr } = await supabase
+                        .from("agent_office_layouts")
+                        .update({
+                        layout,
+                        status: "active",
+                        last_agent_update_at: new Date().toISOString(),
+                        updated_at: new Date().toISOString(),
+                    })
+                        .eq("id", existing.id)
+                        .eq("user_id", userId);
+                    if (updateErr)
+                        return err(`Office save failed: ${updateErr.message}`);
+                    const dataRows = normalized.flatMap((s) => s.widgets.map((w) => ({
+                        user_id: userId,
+                        office_id: existing.id,
+                        widget_id: w.id,
+                        data: {},
+                    })));
+                    if (dataRows.length > 0) {
+                        const { error: dataErr } = await supabase
+                            .from("agent_office_data")
+                            .upsert(dataRows, { onConflict: "office_id,widget_id" });
+                        if (dataErr) {
+                            api.logger.warn?.(`[ofiere-office] widget_data seed failed: ${dataErr.message}`);
+                        }
+                    }
+                    await emitOfficeWebhook(api, "office_update", {
+                        user_id: userId,
+                        office_id: existing.id,
+                        agent_id: agentId,
+                    });
+                    return ok({
+                        message: `Office built with ${normalized.length} sections and ${dataRows.length} widgets`,
+                        office_id: existing.id,
+                        section_count: normalized.length,
+                        widget_count: dataRows.length,
+                    });
+                }
+                case "update_widgets": {
+                    if (!params.office_id)
+                        return err("Missing required: office_id");
+                    if (!Array.isArray(params.operations))
+                        return err("Missing required: operations (array)");
+                    const operations = params.operations;
+                    const agentId = await resolveCallingAgent(params.agent_id);
+                    if (!agentId)
+                        return err("Could not resolve agent_id");
+                    const { data: office, error: loadErr } = await supabase
+                        .from("agent_office_layouts")
+                        .select("id, layout, is_finalized, agent_id")
+                        .eq("id", params.office_id)
+                        .eq("user_id", userId)
+                        .eq("agent_id", agentId)
+                        .maybeSingle();
+                    if (loadErr)
+                        return err(loadErr.message);
+                    if (!office)
+                        return err("Office not found or not owned by this agent");
+                    const layout = office.layout || { version: 1, sections: [] };
+                    const sections = Array.isArray(layout.sections) ? [...layout.sections] : [];
+                    const warnings = [];
+                    const newSeedDataRows = [];
+                    let applied = 0;
+                    let skipped = 0;
+                    for (let i = 0; i < operations.length; i++) {
+                        const op = operations[i];
+                        const path = op?.path || "";
+                        const opType = op?.op || "";
+                        const m = path.match(/^\/sections\/(\d+)(?:\/widgets\/(-|\d+))?(?:\/config)?$/);
+                        if (!m) {
+                            warnings.push(`op[${i}]: unsupported path "${path}"`);
+                            skipped++;
+                            continue;
+                        }
+                        const sIdx = parseInt(m[1], 10);
+                        const wTok = m[2];
+                        const isConfig = path.endsWith("/config");
+                        if (Number.isNaN(sIdx) || sIdx < 0 || sIdx >= sections.length) {
+                            warnings.push(`op[${i}]: section index ${sIdx} out of range`);
+                            skipped++;
+                            continue;
+                        }
+                        const section = sections[sIdx];
+                        if (section.locked) {
+                            warnings.push(`op[${i}]: section "${section.title}" is locked`);
+                            skipped++;
+                            continue;
+                        }
+                        if (wTok === undefined) {
+                            if (opType === "remove") {
+                                sections.splice(sIdx, 1);
+                                applied++;
+                                continue;
+                            }
+                            if (opType === "replace" && op.value) {
+                                const sErr = validateSection(op.value);
+                                if (sErr) {
+                                    warnings.push(`op[${i}]: ${sErr}`);
+                                    skipped++;
+                                    continue;
+                                }
+                                sections[sIdx] = { ...op.value, id: section.id };
+                                applied++;
+                                continue;
+                            }
+                            warnings.push(`op[${i}]: section-level op "${opType}" not supported (use replace/remove)`);
+                            skipped++;
+                            continue;
+                        }
+                        if (wTok === "-") {
+                            if (opType !== "add") {
+                                warnings.push(`op[${i}]: path "/widgets/-" requires op=add`);
+                                skipped++;
+                                continue;
+                            }
+                            const w = op.widget || op.value;
+                            const wErr = validateWidget(w);
+                            if (wErr) {
+                                warnings.push(`op[${i}]: ${wErr}`);
+                                skipped++;
+                                continue;
+                            }
+                            const newW = {
+                                id: typeof w.id === "string" && w.id ? w.id : shortId("wgt"),
+                                type: w.type,
+                                config: w.config || {},
+                                layout: { ...w.layout },
+                                locked: w.locked === true,
+                                data_source: w.data_source || { type: "agent", refresh_interval: 3600, last_refreshed_at: null },
+                            };
+                            section.widgets = [...(section.widgets || []), newW];
+                            newSeedDataRows.push({ widget_id: newW.id });
+                            applied++;
+                            continue;
+                        }
+                        const wIdx = parseInt(wTok, 10);
+                        if (Number.isNaN(wIdx) || wIdx < 0 || wIdx >= (section.widgets || []).length) {
+                            warnings.push(`op[${i}]: widget index ${wIdx} out of range`);
+                            skipped++;
+                            continue;
+                        }
+                        const widget = section.widgets[wIdx];
+                        if (widget.locked) {
+                            warnings.push(`op[${i}]: widget "${widget.id}" is locked`);
+                            skipped++;
+                            continue;
+                        }
+                        if (opType === "remove") {
+                            section.widgets.splice(wIdx, 1);
+                            applied++;
+                        }
+                        else if (opType === "replace" && op.value) {
+                            const wErr = validateWidget(op.value);
+                            if (wErr) {
+                                warnings.push(`op[${i}]: ${wErr}`);
+                                skipped++;
+                                continue;
+                            }
+                            section.widgets[wIdx] = { ...op.value, id: widget.id };
+                            applied++;
+                        }
+                        else if ((opType === "patch" || (opType === "replace" && isConfig)) && op.config) {
+                            section.widgets[wIdx] = { ...widget, config: { ...widget.config, ...op.config } };
+                            applied++;
+                        }
+                        else {
+                            warnings.push(`op[${i}]: widget-level op "${opType}" not handled`);
+                            skipped++;
+                        }
+                    }
+                    const newLayout = { ...layout, sections };
+                    const { error: saveErr } = await supabase
+                        .from("agent_office_layouts")
+                        .update({
+                        layout: newLayout,
+                        last_agent_update_at: new Date().toISOString(),
+                        updated_at: new Date().toISOString(),
+                    })
+                        .eq("id", office.id)
+                        .eq("user_id", userId);
+                    if (saveErr)
+                        return err(`Office save failed: ${saveErr.message}`);
+                    if (newSeedDataRows.length > 0) {
+                        const seedRows = newSeedDataRows.map((r) => ({
+                            user_id: userId,
+                            office_id: office.id,
+                            widget_id: r.widget_id,
+                            data: {},
+                        }));
+                        await supabase
+                            .from("agent_office_data")
+                            .upsert(seedRows, { onConflict: "office_id,widget_id" });
+                    }
+                    await emitOfficeWebhook(api, "office_update", {
+                        user_id: userId,
+                        office_id: office.id,
+                        agent_id: agentId,
+                    });
+                    return ok({ applied, skipped, warnings });
+                }
+                case "update_widget_data": {
+                    if (!params.office_id)
+                        return err("Missing required: office_id");
+                    if (!params.widget_id)
+                        return err("Missing required: widget_id");
+                    if (typeof params.data !== "object" || params.data === null)
+                        return err("Missing required: data (object)");
+                    const agentId = await resolveCallingAgent(params.agent_id);
+                    if (!agentId)
+                        return err("Could not resolve agent_id");
+                    const { data: office, error: loadErr } = await supabase
+                        .from("agent_office_layouts")
+                        .select("id")
+                        .eq("id", params.office_id)
+                        .eq("user_id", userId)
+                        .eq("agent_id", agentId)
+                        .maybeSingle();
+                    if (loadErr)
+                        return err(loadErr.message);
+                    if (!office)
+                        return err("Office not found or not owned by this agent");
+                    const { error: upsertErr } = await supabase
+                        .from("agent_office_data")
+                        .upsert({
+                        user_id: userId,
+                        office_id: office.id,
+                        widget_id: params.widget_id,
+                        data: params.data,
+                        updated_at: new Date().toISOString(),
+                    }, { onConflict: "office_id,widget_id" });
+                    if (upsertErr)
+                        return err(`Widget data save failed: ${upsertErr.message}`);
+                    await emitOfficeWebhook(api, "office_data_update", {
+                        user_id: userId,
+                        office_id: office.id,
+                        agent_id: agentId,
+                        widget_id: params.widget_id,
+                    });
+                    return ok({ message: `Widget ${params.widget_id} data updated` });
+                }
+                default:
+                    return err(`Unknown action: ${action}. Use get_office, build_office, update_widgets, update_widget_data.`);
+            }
+        },
+    }));
+}
+// ═══════════════════════════════════════════════════════════════════════════════
 // Public: Register All Meta-Tools
 // ═══════════════════════════════════════════════════════════════════════════════
 // This is the single entry point called by index.ts.
@@ -6488,6 +6918,7 @@ supabase, config) {
     registerBrainOps(api, supabase, userId, resolveAgent); // 14
     registerTalentOps(api, supabase, userId); // 15
     registerFrameworkOps(api, supabase, userId, resolveAgent); // 16
+    registerOfficeOps(api, supabase, userId, resolveAgent); // 17
     // ── Register dynamic brain context hook ──
     registerBrainContextHook(api, supabase, userId, fallbackAgentId);
     // ── Register talent context hook ──
@@ -6497,7 +6928,7 @@ supabase, config) {
     // ── Register agent_end hook for server-side brain extraction ──
     registerBrainExtractionHook(api, supabase, userId, fallbackAgentId);
     // ── Count and log ──
-    const toolCount = 16;
+    const toolCount = 17;
     const callerName = getCallingAgentName(api);
     const agentLabel = fallbackAgentId || callerName || "auto-detect";
     api.logger.info(`[ofiere] ${toolCount} meta-tools registered (agent: ${agentLabel})`);

package/openclaw.plugin.json

@@ -48,7 +48,8 @@
       "OFIERE_SOP_OPS",
       "OFIERE_FRAMEWORK_OPS",
       "OFIERE_BRAIN_OPS",
-      "OFIERE_TALENT_OPS"
+      "OFIERE_TALENT_OPS",
+      "OFIERE_OFFICE_OPS"
     ]
   },
   "activation": {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "ofiere-openclaw-plugin",
-  "version": "4.53.0",
+  "version": "4.54.1",
   "type": "module",
-  "description": "OpenClaw plugin for Ofiere PM - 16 meta-tools covering tasks, agents, projects, scheduling, knowledge, workflows, notifications, memory, prompts, constellation, space file management, execution plan builder, SOP management, agent brain, talent management, and corporate frameworks",
+  "description": "OpenClaw plugin for Ofiere PM - 17 meta-tools covering tasks, agents, projects, scheduling, knowledge, workflows, notifications, memory, prompts, constellation, space file management, execution plan builder, SOP management, agent brain, talent management, corporate frameworks, and agent office canvas",
   "keywords": ["openclaw", "ofiere", "project-management", "agents", "plugin"],
   "homepage": "https://github.com/gilanggemar/Ofiere",
   "repository": {

package/src/tools.ts

@@ -6599,6 +6599,453 @@ function registerTalentContextHook(
   }
 }
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// META-TOOL 17: OFIERE_OFFICE_OPS — Agent Office Canvas (widget dashboard)
+// ═══════════════════════════════════════════════════════════════════════════════
+
+async function emitOfficeWebhook(
+  api: any,
+  type: "office_update" | "office_data_update",
+  payload: Record<string, unknown>,
+): Promise<void> {
+  const webhookUrl = process.env.OFIERE_DASHBOARD_WEBHOOK_URL || "";
+  const webhookSecret = process.env.OPENCLAW_WEBHOOK_SECRET || "";
+  if (!webhookUrl || !webhookSecret) return;
+  try {
+    await fetch(webhookUrl, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${webhookSecret}`,
+      },
+      body: JSON.stringify({ type, payload }),
+    });
+  } catch (wErr) {
+    api.logger.debug?.(`[ofiere-office] webhook post failed: ${wErr instanceof Error ? wErr.message : String(wErr)}`);
+  }
+}
+
+function validateSection(s: any): string | null {
+  if (!s || typeof s !== "object") return "section is not an object";
+  if (typeof s.title !== "string" || !s.title) return "section.title required";
+  if (typeof s.order !== "number") return "section.order must be a number";
+  if (!Array.isArray(s.widgets)) return "section.widgets must be an array";
+  for (const w of s.widgets) {
+    const wErr = validateWidget(w);
+    if (wErr) return `section "${s.title}": ${wErr}`;
+  }
+  return null;
+}
+
+function validateWidget(w: any): string | null {
+  if (!w || typeof w !== "object") return "widget is not an object";
+  if (typeof w.type !== "string" || !w.type) return "widget.type required";
+  if (typeof w.config !== "object" || w.config === null) return "widget.config must be an object";
+  const ly = w.layout;
+  if (!ly || typeof ly !== "object") return "widget.layout required";
+  if (typeof ly.x !== "number" || typeof ly.y !== "number" || typeof ly.w !== "number" || typeof ly.h !== "number") {
+    return "widget.layout must have numeric x, y, w, h";
+  }
+  return null;
+}
+
+function shortId(prefix: string): string {
+  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+}
+
+function registerOfficeOps(
+  api: any,
+  supabase: SupabaseClient,
+  userId: string,
+  resolveAgent: (id?: string) => Promise<string | null>,
+): void {
+  api.registerTool((toolCtx: any) => ({
+    name: "OFIERE_OFFICE_OPS",
+    label: "Ofiere Office Operations",
+    description:
+      `Build and update your department Office — a widget-based dashboard canvas bound to a PM Space.\n\n` +
+      `Actions:\n` +
+      `- "get_office": Load the current layout + widget data for a given (space_id, agent_id). Optional: space_id, agent_id.\n` +
+      `- "build_office": One-time initial build. Required: space_id, sections. Only callable while the office row is in 'initializing' state.\n` +
+      `- "update_widgets": Modify the layout (add/remove/replace/patch widgets or sections). Required: office_id, operations. Locked items are skipped (returns warnings).\n` +
+      `- "update_widget_data": Push fresh data for a single widget. Required: office_id, widget_id, data. Always succeeds regardless of lock state — locks protect layout, not data.\n\n` +
+      `Layout shape:\n` +
+      `  { version: 1, sections: [ { id, title, description?, order, locked?, collapsed?, columns, widgets: [ { id, type, config, layout: {x,y,w,h}, locked?, data_source? } ] } ] }\n\n` +
+      `Widget catalog (the dashboard knows which types exist): kpi_card, bar_chart, line_chart, donut_chart, progress_bar, sparkline, heatmap, data_table, activity_feed, report_card, status_list, checklist, text_block, embed, quick_action, file_browser, staff_roster.\n\n` +
+      `Operation shape (RFC-6902 flavored): { op: 'add'|'remove'|'replace'|'patch', path: '/sections/0/widgets/-' or '/sections/0/widgets/0', value?, widget?, config? }`,
+    parameters: {
+      type: "object",
+      required: ["action"],
+      properties: {
+        action: {
+          type: "string",
+          description: "get_office, build_office, update_widgets, update_widget_data",
+        },
+        space_id: { type: "string", description: "PM space UUID" },
+        agent_id: { type: "string", description: "Agent identifier (defaults to calling agent)" },
+        office_id: { type: "string", description: "Office row UUID" },
+        widget_id: { type: "string", description: "Widget short id" },
+        sections: { type: "array", description: "Initial layout sections (build_office only)" },
+        operations: { type: "array", description: "Patch operations (update_widgets only)" },
+        data: { type: "object", description: "Widget data payload (update_widget_data only)" },
+      },
+    },
+    async execute(_id: string, params: Record<string, unknown>) {
+      const action = params.action as string;
+      const ctxAgentHint = toolCtx?.agentAccountId || toolCtx?.agentId || "";
+
+      async function resolveCallingAgent(explicitId?: string): Promise<string | null> {
+        if (explicitId && explicitId.trim()) return resolveAgent(explicitId);
+        if (ctxAgentHint) return resolveAgent(ctxAgentHint);
+        return resolveAgent();
+      }
+
+      switch (action) {
+        case "get_office": {
+          const agentId = await resolveCallingAgent(params.agent_id as string);
+          if (!agentId) return err("Could not resolve agent_id");
+
+          let q = supabase
+            .from("agent_office_layouts")
+            .select("id, space_id, agent_id, status, is_finalized, layout, last_agent_update_at, error_message, updated_at")
+            .eq("user_id", userId)
+            .eq("agent_id", agentId);
+          if (params.space_id) q = q.eq("space_id", params.space_id as string);
+
+          const { data: rows, error } = await q.limit(1);
+          if (error) return err(error.message);
+          if (!rows || rows.length === 0) return err("No office found for this agent");
+
+          const office = rows[0];
+          const { data: widgetData } = await supabase
+            .from("agent_office_data")
+            .select("widget_id, data, updated_at")
+            .eq("user_id", userId)
+            .eq("office_id", office.id);
+
+          const dataMap: Record<string, any> = {};
+          for (const row of widgetData || []) {
+            dataMap[row.widget_id] = row.data;
+          }
+
+          return ok({ office, widget_data: dataMap });
+        }
+
+        case "build_office": {
+          if (!params.space_id) return err("Missing required: space_id");
+          if (!Array.isArray(params.sections)) return err("Missing required: sections (array)");
+
+          const agentId = await resolveCallingAgent(params.agent_id as string);
+          if (!agentId) return err("Could not resolve agent_id");
+
+          const inputSections = params.sections as any[];
+          for (let i = 0; i < inputSections.length; i++) {
+            const sErr = validateSection(inputSections[i]);
+            if (sErr) return err(`Validation failed at section[${i}]: ${sErr}`);
+          }
+
+          const { data: existing, error: loadErr } = await supabase
+            .from("agent_office_layouts")
+            .select("id, status")
+            .eq("user_id", userId)
+            .eq("space_id", params.space_id as string)
+            .eq("agent_id", agentId)
+            .maybeSingle();
+
+          if (loadErr) return err(`Office lookup failed: ${loadErr.message}`);
+          if (!existing) return err("Office row not found — dashboard must call /api/office/initialize first");
+          if (existing.status !== "initializing") {
+            return err(`Office already built (status=${existing.status}). Use update_widgets to modify.`);
+          }
+
+          const normalized = inputSections.map((s, idx) => {
+            const widgets = (s.widgets || []).map((w: any) => ({
+              id: typeof w.id === "string" && w.id ? w.id : shortId("wgt"),
+              type: w.type,
+              config: w.config || {},
+              layout: {
+                x: w.layout.x,
+                y: w.layout.y,
+                w: w.layout.w,
+                h: w.layout.h,
+                minW: w.layout.minW,
+                minH: w.layout.minH,
+                maxW: w.layout.maxW,
+                maxH: w.layout.maxH,
+              },
+              locked: w.locked === true,
+              data_source: w.data_source || { type: "agent", refresh_interval: 3600, last_refreshed_at: null },
+            }));
+            return {
+              id: typeof s.id === "string" && s.id ? s.id : shortId("sec"),
+              title: s.title,
+              description: s.description,
+              order: typeof s.order === "number" ? s.order : idx,
+              locked: s.locked === true,
+              collapsed: s.collapsed === true,
+              columns: typeof s.columns === "number" ? s.columns : 3,
+              widgets,
+            };
+          });
+
+          const layout = { version: 1, sections: normalized };
+
+          const { error: updateErr } = await supabase
+            .from("agent_office_layouts")
+            .update({
+              layout,
+              status: "active",
+              last_agent_update_at: new Date().toISOString(),
+              updated_at: new Date().toISOString(),
+            })
+            .eq("id", existing.id)
+            .eq("user_id", userId);
+
+          if (updateErr) return err(`Office save failed: ${updateErr.message}`);
+
+          const dataRows = normalized.flatMap((s: any) =>
+            s.widgets.map((w: any) => ({
+              user_id: userId,
+              office_id: existing.id,
+              widget_id: w.id,
+              data: {},
+            })),
+          );
+
+          if (dataRows.length > 0) {
+            const { error: dataErr } = await supabase
+              .from("agent_office_data")
+              .upsert(dataRows, { onConflict: "office_id,widget_id" });
+            if (dataErr) {
+              api.logger.warn?.(`[ofiere-office] widget_data seed failed: ${dataErr.message}`);
+            }
+          }
+
+          await emitOfficeWebhook(api, "office_update", {
+            user_id: userId,
+            office_id: existing.id,
+            agent_id: agentId,
+          });
+
+          return ok({
+            message: `Office built with ${normalized.length} sections and ${dataRows.length} widgets`,
+            office_id: existing.id,
+            section_count: normalized.length,
+            widget_count: dataRows.length,
+          });
+        }
+
+        case "update_widgets": {
+          if (!params.office_id) return err("Missing required: office_id");
+          if (!Array.isArray(params.operations)) return err("Missing required: operations (array)");
+          const operations = params.operations as any[];
+
+          const agentId = await resolveCallingAgent(params.agent_id as string);
+          if (!agentId) return err("Could not resolve agent_id");
+
+          const { data: office, error: loadErr } = await supabase
+            .from("agent_office_layouts")
+            .select("id, layout, is_finalized, agent_id")
+            .eq("id", params.office_id as string)
+            .eq("user_id", userId)
+            .eq("agent_id", agentId)
+            .maybeSingle();
+
+          if (loadErr) return err(loadErr.message);
+          if (!office) return err("Office not found or not owned by this agent");
+
+          const layout: any = office.layout || { version: 1, sections: [] };
+          const sections: any[] = Array.isArray(layout.sections) ? [...layout.sections] : [];
+          const warnings: string[] = [];
+          const newSeedDataRows: { widget_id: string }[] = [];
+          let applied = 0;
+          let skipped = 0;
+
+          for (let i = 0; i < operations.length; i++) {
+            const op = operations[i];
+            const path: string = op?.path || "";
+            const opType: string = op?.op || "";
+
+            const m = path.match(/^\/sections\/(\d+)(?:\/widgets\/(-|\d+))?(?:\/config)?$/);
+            if (!m) {
+              warnings.push(`op[${i}]: unsupported path "${path}"`);
+              skipped++;
+              continue;
+            }
+
+            const sIdx = parseInt(m[1], 10);
+            const wTok = m[2];
+            const isConfig = path.endsWith("/config");
+
+            if (Number.isNaN(sIdx) || sIdx < 0 || sIdx >= sections.length) {
+              warnings.push(`op[${i}]: section index ${sIdx} out of range`);
+              skipped++;
+              continue;
+            }
+            const section = sections[sIdx];
+            if (section.locked) {
+              warnings.push(`op[${i}]: section "${section.title}" is locked`);
+              skipped++;
+              continue;
+            }
+
+            if (wTok === undefined) {
+              if (opType === "remove") {
+                sections.splice(sIdx, 1);
+                applied++;
+                continue;
+              }
+              if (opType === "replace" && op.value) {
+                const sErr = validateSection(op.value);
+                if (sErr) { warnings.push(`op[${i}]: ${sErr}`); skipped++; continue; }
+                sections[sIdx] = { ...op.value, id: section.id };
+                applied++;
+                continue;
+              }
+              warnings.push(`op[${i}]: section-level op "${opType}" not supported (use replace/remove)`);
+              skipped++;
+              continue;
+            }
+
+            if (wTok === "-") {
+              if (opType !== "add") {
+                warnings.push(`op[${i}]: path "/widgets/-" requires op=add`);
+                skipped++;
+                continue;
+              }
+              const w = op.widget || op.value;
+              const wErr = validateWidget(w);
+              if (wErr) { warnings.push(`op[${i}]: ${wErr}`); skipped++; continue; }
+              const newW = {
+                id: typeof w.id === "string" && w.id ? w.id : shortId("wgt"),
+                type: w.type,
+                config: w.config || {},
+                layout: { ...w.layout },
+                locked: w.locked === true,
+                data_source: w.data_source || { type: "agent", refresh_interval: 3600, last_refreshed_at: null },
+              };
+              section.widgets = [...(section.widgets || []), newW];
+              newSeedDataRows.push({ widget_id: newW.id });
+              applied++;
+              continue;
+            }
+
+            const wIdx = parseInt(wTok, 10);
+            if (Number.isNaN(wIdx) || wIdx < 0 || wIdx >= (section.widgets || []).length) {
+              warnings.push(`op[${i}]: widget index ${wIdx} out of range`);
+              skipped++;
+              continue;
+            }
+            const widget = section.widgets[wIdx];
+            if (widget.locked) {
+              warnings.push(`op[${i}]: widget "${widget.id}" is locked`);
+              skipped++;
+              continue;
+            }
+
+            if (opType === "remove") {
+              section.widgets.splice(wIdx, 1);
+              applied++;
+            } else if (opType === "replace" && op.value) {
+              const wErr = validateWidget(op.value);
+              if (wErr) { warnings.push(`op[${i}]: ${wErr}`); skipped++; continue; }
+              section.widgets[wIdx] = { ...op.value, id: widget.id };
+              applied++;
+            } else if ((opType === "patch" || (opType === "replace" && isConfig)) && op.config) {
+              section.widgets[wIdx] = { ...widget, config: { ...widget.config, ...op.config } };
+              applied++;
+            } else {
+              warnings.push(`op[${i}]: widget-level op "${opType}" not handled`);
+              skipped++;
+            }
+          }
+
+          const newLayout = { ...layout, sections };
+
+          const { error: saveErr } = await supabase
+            .from("agent_office_layouts")
+            .update({
+              layout: newLayout,
+              last_agent_update_at: new Date().toISOString(),
+              updated_at: new Date().toISOString(),
+            })
+            .eq("id", office.id)
+            .eq("user_id", userId);
+
+          if (saveErr) return err(`Office save failed: ${saveErr.message}`);
+
+          if (newSeedDataRows.length > 0) {
+            const seedRows = newSeedDataRows.map((r) => ({
+              user_id: userId,
+              office_id: office.id,
+              widget_id: r.widget_id,
+              data: {},
+            }));
+            await supabase
+              .from("agent_office_data")
+              .upsert(seedRows, { onConflict: "office_id,widget_id" });
+          }
+
+          await emitOfficeWebhook(api, "office_update", {
+            user_id: userId,
+            office_id: office.id,
+            agent_id: agentId,
+          });
+
+          return ok({ applied, skipped, warnings });
+        }
+
+        case "update_widget_data": {
+          if (!params.office_id) return err("Missing required: office_id");
+          if (!params.widget_id) return err("Missing required: widget_id");
+          if (typeof params.data !== "object" || params.data === null) return err("Missing required: data (object)");
+
+          const agentId = await resolveCallingAgent(params.agent_id as string);
+          if (!agentId) return err("Could not resolve agent_id");
+
+          const { data: office, error: loadErr } = await supabase
+            .from("agent_office_layouts")
+            .select("id")
+            .eq("id", params.office_id as string)
+            .eq("user_id", userId)
+            .eq("agent_id", agentId)
+            .maybeSingle();
+
+          if (loadErr) return err(loadErr.message);
+          if (!office) return err("Office not found or not owned by this agent");
+
+          const { error: upsertErr } = await supabase
+            .from("agent_office_data")
+            .upsert(
+              {
+                user_id: userId,
+                office_id: office.id,
+                widget_id: params.widget_id as string,
+                data: params.data,
+                updated_at: new Date().toISOString(),
+              },
+              { onConflict: "office_id,widget_id" },
+            );
+
+          if (upsertErr) return err(`Widget data save failed: ${upsertErr.message}`);
+
+          await emitOfficeWebhook(api, "office_data_update", {
+            user_id: userId,
+            office_id: office.id,
+            agent_id: agentId,
+            widget_id: params.widget_id,
+          });
+
+          return ok({ message: `Widget ${params.widget_id} data updated` });
+        }
+
+        default:
+          return err(`Unknown action: ${action}. Use get_office, build_office, update_widgets, update_widget_data.`);
+      }
+    },
+  }));
+}
+
 // ═══════════════════════════════════════════════════════════════════════════════
 // Public: Register All Meta-Tools
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -6631,7 +7078,8 @@ export function registerTools(
   registerSOPOps(api, supabase, userId, resolveAgent);        // 13
   registerBrainOps(api, supabase, userId, resolveAgent);      // 14
   registerTalentOps(api, supabase, userId);                   // 15
-  registerFrameworkOps(api, supabase, userId, resolveAgent);   // 16
+  registerFrameworkOps(api, supabase, userId, resolveAgent);  // 16
+  registerOfficeOps(api, supabase, userId, resolveAgent);     // 17
 
   // ── Register dynamic brain context hook ──
   registerBrainContextHook(api, supabase, userId, fallbackAgentId);
@@ -6646,7 +7094,7 @@ export function registerTools(
   registerBrainExtractionHook(api, supabase, userId, fallbackAgentId);
 
   // ── Count and log ──
-  const toolCount = 16;
+  const toolCount = 17;
   const callerName = getCallingAgentName(api);
   const agentLabel = fallbackAgentId || callerName || "auto-detect";
   api.logger.info(`[ofiere] ${toolCount} meta-tools registered (agent: ${agentLabel})`);