@useorgx/openclaw-plugin 0.4.9 → 0.7.0

package/dist/tools/core-tools.js

@@ -1,8 +1,10 @@
 import { randomUUID as randomUuidFn } from "node:crypto";
 import { registerArtifact } from "../artifacts/register-artifact.js";
+import { validateOpenClawSkillPackManifest } from "../contracts/skill-pack-schema.js";
+import { listBuiltInSentinels } from "../http/helpers/sentinel-catalog.js";
 import { appendToOutbox } from "../outbox.js";
 export function registerCoreTools(deps) {
-    const { registerTool, client, config, getCachedSnapshot, getLastSnapshotAt, doSync, text, json, formatSnapshot, autoAssignEntityForCreate, toReportingPhase, inferReportingInitiativeId, isUuid, pickNonEmptyString, resolveReportingContext, readSkillPackState, } = deps;
+    const { registerTool, client, config, getCachedSnapshot, getLastSnapshotAt, doSync, text, json, formatSnapshot, autoAssignEntityForCreate, toReportingPhase, inferReportingInitiativeId, isUuid, pickNonEmptyString, resolveReportingContext, readSkillPackState, updateSkillPackPolicy, rollbackSkillPackPolicy, } = deps;
     const randomUUID = deps.randomUUID ?? randomUuidFn;
     const mcpToolRegistry = new Map();
     const registerMcpTool = (tool, options) => {
@@ -31,6 +33,34 @@ export function registerCoreTools(deps) {
         },
     }, { optional: true });
     // --- orgx_sync ---
+    registerMcpTool({
+        name: "orgx_sentinel_catalog",
+        description: "List built-in proactive sentinel templates. Supports optional domain filter.",
+        parameters: {
+            type: "object",
+            properties: {
+                domain: {
+                    type: "string",
+                    description: "Optional domain filter (engineering, sales, operations, product).",
+                },
+            },
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            try {
+                const sentinels = listBuiltInSentinels({ domain: params.domain });
+                return json("Sentinel catalog:", {
+                    generatedAt: new Date().toISOString(),
+                    domain: params.domain ?? null,
+                    count: sentinels.length,
+                    sentinels,
+                });
+            }
+            catch (err) {
+                return text(`❌ Failed to load sentinel catalog: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
     registerMcpTool({
         name: "orgx_sync",
         description: "Push/pull memory sync with OrgX. Send local memory/daily log; receive initiatives, tasks, decisions, model routing policy.",
@@ -45,13 +75,35 @@ export function registerCoreTools(deps) {
                     type: "string",
                     description: "Today's session log to push",
                 },
+                agents: {
+                    type: "array",
+                    description: "Optional local agent states to sync into OrgX",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string" },
+                            name: { type: "string" },
+                            domain: { type: "string" },
+                            status: {
+                                type: "string",
+                                enum: ["active", "idle", "throttled"],
+                            },
+                            currentTask: { type: "string" },
+                            lastActive: { type: "string" },
+                        },
+                        required: ["id", "name", "domain", "status"],
+                        additionalProperties: false,
+                    },
+                },
             },
+            additionalProperties: false,
         },
         async execute(_callId, params = {}) {
             try {
                 const resp = await client.syncMemory({
                     memory: params.memory,
                     dailyLog: params.dailyLog,
+                    agents: params.agents,
                 });
                 return json("Sync complete:", resp);
             }
@@ -286,6 +338,235 @@ export function registerCoreTools(deps) {
             }
         },
     }, { optional: true });
+    // --- orgx_proof_status ---
+    registerMcpTool({
+        name: "orgx_proof_status",
+        description: "Check the proof chain status for a task or run. Returns a checklist of proof levels (L1-L7) with gaps highlighted. Use this to verify work is provably complete before marking done.",
+        parameters: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "ID of the task to check proof for",
+                },
+                run_id: {
+                    type: "string",
+                    description: "ID of the run to check proof for",
+                },
+            },
+        },
+        async execute(_callId, params = {}) {
+            const taskId = params.task_id || undefined;
+            const runId = params.run_id || undefined;
+            if (!taskId && !runId) {
+                return text("❌ Provide at least one of task_id or run_id.");
+            }
+            try {
+                const qp = new URLSearchParams();
+                if (taskId)
+                    qp.set("task_id", taskId);
+                if (runId)
+                    qp.set("run_id", runId);
+                const result = await client.rawRequest("GET", `/api/flywheel/proof-status?${qp.toString()}`);
+                // Format proof chain as readable checklist
+                const levels = Array.isArray(result?.levels) ? result.levels : [];
+                const overall = result?.overall_passed === true;
+                const reasonCodes = Array.isArray(result?.reason_codes) ? result.reason_codes : [];
+                if (levels.length === 0) {
+                    // Server may not have proof-status route yet (phase 1)
+                    return json("Proof status (local evaluation)", {
+                        task_id: taskId,
+                        run_id: runId,
+                        note: "Proof-status API not available. Register artifacts with atomic_unit_type metadata and use orgx_quality_score to build proof chain.",
+                        overall_passed: false,
+                        reason_codes: ["proof_api_not_available"],
+                    });
+                }
+                const lines = [];
+                lines.push(overall ? "✅ Proof chain complete" : "⚠️ Proof chain incomplete");
+                lines.push("");
+                for (const lvl of levels) {
+                    const icon = lvl.passed ? "✅" : lvl.enforcement === "soft_warn" ? "⚠️" : "❌";
+                    lines.push(`${icon} ${lvl.label || lvl.level}: ${lvl.passed ? "passed" : "missing"}`);
+                    if (Array.isArray(lvl.missingFields) && lvl.missingFields.length > 0) {
+                        lines.push(`   Missing: ${lvl.missingFields.join(", ")}`);
+                    }
+                }
+                if (reasonCodes.length > 0) {
+                    lines.push("");
+                    lines.push(`Reason codes: ${reasonCodes.join(", ")}`);
+                }
+                return json(lines.join("\n"), result);
+            }
+            catch (err) {
+                // Graceful degradation: if proof API is not deployed, return helpful guidance
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes("404") || msg.includes("not found") || msg.includes("Not Found")) {
+                    return json("Proof status (server not ready)", {
+                        task_id: taskId,
+                        run_id: runId,
+                        note: "Proof-status API not deployed yet. Ensure artifacts are registered with atomic_unit_type metadata to build the proof chain.",
+                        overall_passed: false,
+                        reason_codes: ["proof_api_not_deployed"],
+                    });
+                }
+                return text(`❌ Proof status check failed: ${msg}`);
+            }
+        },
+    }, { optional: true });
+    // --- orgx_verify_completion ---
+    registerMcpTool({
+        name: "orgx_verify_completion",
+        description: "Verify that an entity (task/milestone/workstream) meets completion requirements including proof chain. Returns structured result with any blocking issues.",
+        parameters: {
+            type: "object",
+            properties: {
+                entity_type: {
+                    type: "string",
+                    description: "Entity type: task, milestone, workstream",
+                },
+                entity_id: {
+                    type: "string",
+                    description: "ID of the entity to verify",
+                },
+            },
+            required: ["entity_type", "entity_id"],
+        },
+        async execute(_callId, params = {
+            entity_type: "",
+            entity_id: "",
+        }) {
+            try {
+                const result = await client.rawRequest("POST", "/api/client/entities/verify-completion", {
+                    entity_type: params.entity_type,
+                    entity_id: params.entity_id,
+                });
+                const ready = result?.ready === true;
+                return json(ready
+                    ? `✅ ${params.entity_type} ${params.entity_id} is ready for completion.`
+                    : `⚠️ ${params.entity_type} ${params.entity_id} has blocking issues.`, result);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes("404") || msg.includes("not found") || msg.includes("Not Found")) {
+                    return json("Completion verification (server not ready)", {
+                        entity_type: params.entity_type,
+                        entity_id: params.entity_id,
+                        ready: true,
+                        note: "Completion verification API not deployed. Proceeding with standard completion.",
+                    });
+                }
+                return text(`❌ Completion verification failed: ${msg}`);
+            }
+        },
+    }, { optional: true });
+    // --- orgx_record_outcome ---
+    registerMcpTool({
+        name: "orgx_record_outcome",
+        description: "Record an outcome event for a completed run, linking execution to business value. Required for L5 (Impact) proof level.",
+        parameters: {
+            type: "object",
+            properties: {
+                initiative_id: {
+                    type: "string",
+                    description: "Initiative ID this outcome belongs to",
+                },
+                execution_id: {
+                    type: "string",
+                    description: "Execution/run ID that produced this outcome",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Agent that did the work",
+                },
+                success: {
+                    type: "boolean",
+                    description: "Whether the execution was successful",
+                },
+                quality_score: {
+                    type: "number",
+                    description: "Quality score 1-5",
+                },
+                domain: {
+                    type: "string",
+                    description: "Agent domain",
+                },
+                metadata: {
+                    type: "object",
+                    description: "Additional outcome metadata",
+                },
+            },
+            required: ["initiative_id", "execution_id", "agent_id", "success"],
+        },
+        async execute(_callId, params = {
+            initiative_id: "",
+            execution_id: "",
+            agent_id: "",
+            success: false,
+        }) {
+            try {
+                const result = await client.recordRunOutcome({
+                    initiative_id: params.initiative_id,
+                    execution_id: params.execution_id,
+                    execution_type: "agent_run",
+                    agent_id: params.agent_id,
+                    success: params.success,
+                    quality_score: params.quality_score,
+                    domain: params.domain,
+                    metadata: params.metadata,
+                });
+                return json(`✅ Outcome recorded for run ${result.run_id} (event: ${result.event_id})`, result);
+            }
+            catch (err) {
+                return text(`❌ Outcome recording failed: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
+    // --- orgx_get_outcome_attribution ---
+    registerMcpTool({
+        name: "orgx_get_outcome_attribution",
+        description: "Get outcome attribution data for a task or run. Shows what value was attributed to the work and with what confidence. Required for L6 (Economics) proof level.",
+        parameters: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "Task ID to get attribution for",
+                },
+                run_id: {
+                    type: "string",
+                    description: "Run ID to get attribution for",
+                },
+            },
+        },
+        async execute(_callId, params = {}) {
+            const taskId = params.task_id || undefined;
+            const runId = params.run_id || undefined;
+            if (!taskId && !runId) {
+                return text("❌ Provide at least one of task_id or run_id.");
+            }
+            try {
+                const qp = new URLSearchParams();
+                if (taskId)
+                    qp.set("task_id", taskId);
+                if (runId)
+                    qp.set("run_id", runId);
+                const result = await client.rawRequest("GET", `/api/flywheel/outcome-attribution?${qp.toString()}`);
+                return json("Outcome attribution", result);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes("404") || msg.includes("not found") || msg.includes("Not Found")) {
+                    return json("Outcome attribution (not available)", {
+                        task_id: taskId,
+                        run_id: runId,
+                        note: "Attribution API not deployed yet.",
+                    });
+                }
+                return text(`❌ Attribution lookup failed: ${msg}`);
+            }
+        },
+    }, { optional: true });
     // --- orgx_create_entity ---
     registerMcpTool({
         name: "orgx_create_entity",
@@ -317,9 +598,13 @@ export function registerCoreTools(deps) {
                     type: "string",
                     description: "Parent workstream ID (for tasks)",
                 },
+                workspace_id: {
+                    type: "string",
+                    description: "Workspace ID (canonical; preferred for new callers)",
+                },
                 command_center_id: {
                     type: "string",
-                    description: "Command center ID (for initiatives)",
+                    description: "Deprecated alias for workspace_id",
                 },
             },
             required: ["type", "title"],
@@ -404,14 +689,537 @@ export function registerCoreTools(deps) {
         async execute(_callId, params = {}) {
             try {
                 const { type, id, ...updates } = params;
-                const entity = await client.updateEntity(type, id, updates);
-                return json(`✅ Updated ${type} ${id.slice(0, 8)}`, entity);
+                const result = await client.updateEntityDetailed(type, id, updates);
+                const payload = result.reassignment || result.initiative_reassignment
+                    ? {
+                        entity: result.entity,
+                        reassignment: result.reassignment ?? null,
+                        initiative_reassignment: result.initiative_reassignment ?? null,
+                    }
+                    : result.entity;
+                return json(`✅ Updated ${type} ${id.slice(0, 8)}`, payload);
             }
             catch (err) {
                 return text(`❌ Update failed: ${err instanceof Error ? err.message : err}`);
             }
         },
     }, { optional: true });
+    // --- orgx_reassign_stream ---
+    registerMcpTool({
+        name: "orgx_reassign_stream",
+        description: "Reassign a workstream's stream ownership/agents and return reassignment scheduling details.",
+        parameters: {
+            type: "object",
+            properties: {
+                workstream_id: {
+                    type: "string",
+                    description: "Workstream UUID to reassign",
+                    minLength: 1,
+                },
+                initiative_id: {
+                    type: "string",
+                    description: "Parent initiative UUID",
+                    minLength: 1,
+                },
+                status: {
+                    type: "string",
+                    description: "Optional workstream status override (active, in_progress, pending, etc.)",
+                    minLength: 1,
+                },
+                domain: {
+                    type: "string",
+                    description: "Optional target domain for the reassigned stream",
+                    minLength: 1,
+                },
+                role: {
+                    type: "string",
+                    description: "Optional role hint for assignment routing",
+                    minLength: 1,
+                },
+                assigned_agent_ids: {
+                    type: "array",
+                    items: { type: "string", minLength: 1 },
+                    description: "Optional assigned agent IDs",
+                },
+                assignedAgentIds: {
+                    type: "array",
+                    items: { type: "string", minLength: 1 },
+                    description: "Alias for assigned_agent_ids",
+                },
+                assigned_agent_names: {
+                    type: "array",
+                    items: { type: "string", minLength: 1 },
+                    description: "Optional assigned agent display names",
+                },
+                assignedAgentNames: {
+                    type: "array",
+                    items: { type: "string", minLength: 1 },
+                    description: "Alias for assigned_agent_names",
+                },
+                assigned_agents: {
+                    type: "array",
+                    description: "Optional structured assigned agent list",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string" },
+                            name: { type: "string" },
+                            domain: { type: "string" },
+                            role: { type: "string" },
+                        },
+                        additionalProperties: false,
+                    },
+                },
+            },
+            required: ["workstream_id", "initiative_id"],
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            try {
+                const workstreamId = pickNonEmptyString(params.workstream_id);
+                const initiativeId = pickNonEmptyString(params.initiative_id);
+                if (!workstreamId || !initiativeId) {
+                    return text("❌ workstream_id and initiative_id are required.");
+                }
+                if (!isUuid(workstreamId)) {
+                    return text("❌ workstream_id must be a valid UUID.");
+                }
+                if (!isUuid(initiativeId)) {
+                    return text("❌ initiative_id must be a valid UUID.");
+                }
+                const normalizeOptionalString = (value, field) => {
+                    if (value === undefined)
+                        return { ok: true, value: undefined };
+                    if (typeof value !== "string") {
+                        return { ok: false, error: `❌ ${field} must be a string when provided.` };
+                    }
+                    const trimmed = value.trim();
+                    return { ok: true, value: trimmed || undefined };
+                };
+                const normalizeStringArray = (value, field) => {
+                    if (value === undefined)
+                        return { ok: true, value: undefined };
+                    if (!Array.isArray(value)) {
+                        return { ok: false, error: `❌ ${field} must be an array of strings.` };
+                    }
+                    const normalized = [];
+                    for (const entry of value) {
+                        if (typeof entry !== "string" || !entry.trim()) {
+                            return { ok: false, error: `❌ ${field} entries must be non-empty strings.` };
+                        }
+                        normalized.push(entry.trim());
+                    }
+                    return { ok: true, value: normalized };
+                };
+                const normalizeAssignedAgents = (value) => {
+                    if (value === undefined)
+                        return { ok: true, value: undefined };
+                    if (!Array.isArray(value)) {
+                        return { ok: false, error: "❌ assigned_agents must be an array when provided." };
+                    }
+                    const normalized = [];
+                    for (const entry of value) {
+                        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+                            return {
+                                ok: false,
+                                error: "❌ assigned_agents entries must be objects with id, name, domain, or role.",
+                            };
+                        }
+                        const candidate = entry;
+                        const normalizedEntry = {};
+                        for (const key of ["id", "name", "domain", "role"]) {
+                            if (!(key in candidate) || candidate[key] === undefined || candidate[key] === null)
+                                continue;
+                            const valueAtKey = candidate[key];
+                            if (typeof valueAtKey !== "string" || !valueAtKey.trim()) {
+                                return {
+                                    ok: false,
+                                    error: `❌ assigned_agents.${key} must be a non-empty string when provided.`,
+                                };
+                            }
+                            normalizedEntry[key] = valueAtKey.trim();
+                        }
+                        if (normalizedEntry.id === undefined &&
+                            normalizedEntry.name === undefined &&
+                            normalizedEntry.domain === undefined &&
+                            normalizedEntry.role === undefined) {
+                            return {
+                                ok: false,
+                                error: "❌ assigned_agents entries must include at least one of id, name, domain, or role.",
+                            };
+                        }
+                        normalized.push(normalizedEntry);
+                    }
+                    return { ok: true, value: normalized };
+                };
+                const arraysEqual = (left, right) => left.length === right.length && left.every((value, idx) => value === right[idx]);
+                const statusInput = normalizeOptionalString(params.status, "status");
+                if (!statusInput.ok)
+                    return text(statusInput.error);
+                const domainInput = normalizeOptionalString(params.domain, "domain");
+                if (!domainInput.ok)
+                    return text(domainInput.error);
+                const roleInput = normalizeOptionalString(params.role, "role");
+                if (!roleInput.ok)
+                    return text(roleInput.error);
+                const assignedAgentIdsSnake = normalizeStringArray(params.assigned_agent_ids, "assigned_agent_ids");
+                if (!assignedAgentIdsSnake.ok)
+                    return text(assignedAgentIdsSnake.error);
+                const assignedAgentIdsCamel = normalizeStringArray(params.assignedAgentIds, "assignedAgentIds");
+                if (!assignedAgentIdsCamel.ok)
+                    return text(assignedAgentIdsCamel.error);
+                const assignedAgentNamesSnake = normalizeStringArray(params.assigned_agent_names, "assigned_agent_names");
+                if (!assignedAgentNamesSnake.ok)
+                    return text(assignedAgentNamesSnake.error);
+                const assignedAgentNamesCamel = normalizeStringArray(params.assignedAgentNames, "assignedAgentNames");
+                if (!assignedAgentNamesCamel.ok)
+                    return text(assignedAgentNamesCamel.error);
+                const assignedAgentsInput = normalizeAssignedAgents(params.assigned_agents);
+                if (!assignedAgentsInput.ok)
+                    return text(assignedAgentsInput.error);
+                if (assignedAgentIdsSnake.value &&
+                    assignedAgentIdsCamel.value &&
+                    !arraysEqual(assignedAgentIdsSnake.value, assignedAgentIdsCamel.value)) {
+                    return text("❌ assigned_agent_ids and assignedAgentIds must match when both are provided.");
+                }
+                if (assignedAgentNamesSnake.value &&
+                    assignedAgentNamesCamel.value &&
+                    !arraysEqual(assignedAgentNamesSnake.value, assignedAgentNamesCamel.value)) {
+                    return text("❌ assigned_agent_names and assignedAgentNames must match when both are provided.");
+                }
+                const normalizedAssignedAgentIds = assignedAgentIdsSnake.value ?? assignedAgentIdsCamel.value;
+                const normalizedAssignedAgentNames = assignedAgentNamesSnake.value ?? assignedAgentNamesCamel.value;
+                const hasReassignmentMutation = domainInput.value !== undefined ||
+                    roleInput.value !== undefined ||
+                    assignedAgentsInput.value !== undefined ||
+                    normalizedAssignedAgentIds !== undefined ||
+                    normalizedAssignedAgentNames !== undefined;
+                if (!hasReassignmentMutation) {
+                    return text("❌ Include at least one reassignment field: domain, role, assigned_agents, assigned_agent_ids, or assigned_agent_names.");
+                }
+                const updates = {
+                    initiative_id: initiativeId,
+                };
+                if (statusInput.value !== undefined)
+                    updates.status = statusInput.value;
+                if (domainInput.value !== undefined)
+                    updates.domain = domainInput.value;
+                if (roleInput.value !== undefined)
+                    updates.role = roleInput.value;
+                if (assignedAgentsInput.value !== undefined)
+                    updates.assigned_agents = assignedAgentsInput.value;
+                if (normalizedAssignedAgentIds !== undefined) {
+                    updates.assigned_agent_ids = normalizedAssignedAgentIds;
+                }
+                if (normalizedAssignedAgentNames !== undefined) {
+                    updates.assigned_agent_names = normalizedAssignedAgentNames;
+                }
+                let beforeDomainFromSnapshot = null;
+                if (typeof client.listEntities === "function") {
+                    try {
+                        const currentWorkstreams = await client.listEntities("workstream", {
+                            initiative_id: initiativeId,
+                            limit: 200,
+                        });
+                        const rows = currentWorkstreams &&
+                            typeof currentWorkstreams === "object" &&
+                            Array.isArray(currentWorkstreams.data)
+                            ? currentWorkstreams.data
+                            : [];
+                        for (const row of rows) {
+                            if (!row || typeof row !== "object" || Array.isArray(row))
+                                continue;
+                            const record = row;
+                            const id = pickNonEmptyString(record.id);
+                            if (id !== workstreamId)
+                                continue;
+                            beforeDomainFromSnapshot = pickNonEmptyString(record.domain) ?? null;
+                            break;
+                        }
+                    }
+                    catch {
+                        // Best effort snapshot for before/after confirmation.
+                    }
+                }
+                const result = await client.updateEntityDetailed("workstream", workstreamId, updates);
+                const entityRecord = result.entity && typeof result.entity === "object" && !Array.isArray(result.entity)
+                    ? result.entity
+                    : null;
+                const reassignmentRecord = result.reassignment &&
+                    typeof result.reassignment === "object" &&
+                    !Array.isArray(result.reassignment)
+                    ? result.reassignment
+                    : null;
+                const beforeDomain = pickNonEmptyString(beforeDomainFromSnapshot, reassignmentRecord?.before_domain, reassignmentRecord?.previous_domain, reassignmentRecord?.from_domain, entityRecord?.before_domain, entityRecord?.previous_domain, entityRecord?.from_domain) ?? null;
+                const afterDomain = pickNonEmptyString(reassignmentRecord?.after_domain, reassignmentRecord?.new_domain, reassignmentRecord?.to_domain, entityRecord?.after_domain, entityRecord?.new_domain, entityRecord?.to_domain, entityRecord?.domain, domainInput.value) ?? null;
+                return json(`✅ Reassigned workstream ${workstreamId.slice(0, 8)}`, {
+                    workstream_id: workstreamId,
+                    before_domain: beforeDomain,
+                    after_domain: afterDomain,
+                    entity: result.entity,
+                    reassignment: result.reassignment ?? null,
+                    initiative_reassignment: result.initiative_reassignment ?? null,
+                });
+            }
+            catch (err) {
+                return text(`❌ Stream reassignment failed: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
+    // --- orgx_reassign_streams ---
+    registerMcpTool({
+        name: "orgx_reassign_streams",
+        description: "Convenience batch reassignment tool. Takes initiative_id and a workstream-to-domain mapping, then updates all listed workstreams.",
+        parameters: {
+            type: "object",
+            properties: {
+                initiative_id: {
+                    type: "string",
+                    description: "Parent initiative UUID for all workstream updates",
+                    minLength: 1,
+                },
+                workstream_domains: {
+                    type: "object",
+                    description: "Mapping of workstream UUID -> target domain",
+                    additionalProperties: {
+                        type: "string",
+                        minLength: 1,
+                    },
+                },
+                mapping: {
+                    type: "object",
+                    description: "Alias for workstream_domains: mapping of workstream UUID -> target domain",
+                    additionalProperties: {
+                        type: "string",
+                        minLength: 1,
+                    },
+                },
+                mappings: {
+                    type: "array",
+                    description: "Optional array mapping for advanced routing fields (workstream_id, domain, role, status).",
+                    items: {
+                        type: "object",
+                        properties: {
+                            workstream_id: {
+                                type: "string",
+                                description: "Workstream UUID to reassign",
+                                minLength: 1,
+                            },
+                            domain: {
+                                type: "string",
+                                description: "Target domain for reassignment",
+                                minLength: 1,
+                            },
+                            role: {
+                                type: "string",
+                                description: "Optional role hint for assignment routing",
+                                minLength: 1,
+                            },
+                            status: {
+                                type: "string",
+                                description: "Optional workstream status override (active, in_progress, pending, etc.)",
+                                minLength: 1,
+                            },
+                        },
+                        required: ["workstream_id", "domain"],
+                        additionalProperties: false,
+                    },
+                },
+                status: {
+                    type: "string",
+                    description: "Optional workstream status override applied to each reassigned stream",
+                    minLength: 1,
+                },
+            },
+            required: ["initiative_id"],
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            try {
+                const initiativeId = pickNonEmptyString(params.initiative_id);
+                if (!initiativeId) {
+                    return text("❌ initiative_id is required.");
+                }
+                if (!isUuid(initiativeId)) {
+                    return text("❌ initiative_id must be a valid UUID.");
+                }
+                const statusInput = params.status;
+                if (statusInput !== undefined && typeof statusInput !== "string") {
+                    return text("❌ status must be a string when provided.");
+                }
+                const normalizedStatus = typeof statusInput === "string" && statusInput.trim().length > 0
+                    ? statusInput.trim()
+                    : undefined;
+                const normalizedMappings = [];
+                const seenWorkstreams = new Set();
+                const addMapping = (workstreamIdRaw, domainRaw, options) => {
+                    const workstreamId = workstreamIdRaw.trim();
+                    if (!workstreamId || !isUuid(workstreamId)) {
+                        return `❌ workstream identifier '${workstreamIdRaw}' must be a valid UUID.`;
+                    }
+                    const domain = domainRaw.trim();
+                    if (!domain) {
+                        return `❌ workstream '${workstreamIdRaw}' must map to a non-empty domain string.`;
+                    }
+                    if (seenWorkstreams.has(workstreamId)) {
+                        return "❌ Duplicate workstream mapping detected.";
+                    }
+                    seenWorkstreams.add(workstreamId);
+                    normalizedMappings.push({
+                        workstreamId,
+                        domain,
+                        ...(options?.role?.trim() ? { role: options.role.trim() } : {}),
+                        ...(options?.status?.trim() ? { status: options.status.trim() } : {}),
+                    });
+                    return null;
+                };
+                if (params.workstream_domains !== undefined) {
+                    if (!params.workstream_domains ||
+                        typeof params.workstream_domains !== "object" ||
+                        Array.isArray(params.workstream_domains)) {
+                        return text("❌ workstream_domains must be an object mapping workstream_id to domain.");
+                    }
+                    const mappingEntries = Object.entries(params.workstream_domains);
+                    for (const [workstreamId, domainValue] of mappingEntries) {
+                        if (typeof domainValue !== "string") {
+                            return text(`❌ workstream_domains['${workstreamId}'] must be a non-empty domain string.`);
+                        }
+                        const error = addMapping(workstreamId, domainValue);
+                        if (error)
+                            return text(error);
+                    }
+                }
+                if (params.mapping !== undefined) {
+                    if (!params.mapping ||
+                        typeof params.mapping !== "object" ||
+                        Array.isArray(params.mapping)) {
+                        return text("❌ mapping must be an object of workstream_id -> domain.");
+                    }
+                    const mappingEntries = Object.entries(params.mapping);
+                    for (const [workstreamId, domainValue] of mappingEntries) {
+                        if (typeof domainValue !== "string") {
+                            return text(`❌ mapping['${workstreamId}'] must be a non-empty domain string.`);
+                        }
+                        const error = addMapping(workstreamId, domainValue);
+                        if (error)
+                            return text(error);
+                    }
+                }
+                if (params.mappings !== undefined) {
+                    if (!Array.isArray(params.mappings)) {
+                        return text("❌ mappings must be an array when provided.");
+                    }
+                    for (const entry of params.mappings) {
+                        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+                            return text("❌ mappings entries must be objects with workstream_id and domain.");
+                        }
+                        const candidate = entry;
+                        const workstreamId = pickNonEmptyString(candidate.workstream_id);
+                        const domain = pickNonEmptyString(candidate.domain);
+                        const role = pickNonEmptyString(candidate.role);
+                        const status = pickNonEmptyString(candidate.status);
+                        if (!workstreamId || !domain) {
+                            return text("❌ Each mappings entry requires workstream_id and domain.");
+                        }
+                        const error = addMapping(workstreamId, domain, { role, status });
+                        if (error)
+                            return text(error);
+                    }
+                }
+                if (normalizedMappings.length === 0) {
+                    return text("❌ Include workstream_domains, mapping, or mappings with at least one workstream reassignment.");
+                }
+                const updates = [];
+                const domainBeforeByWorkstreamId = new Map();
+                if (typeof client.listEntities === "function") {
+                    try {
+                        const currentWorkstreams = await client.listEntities("workstream", {
+                            initiative_id: initiativeId,
+                            limit: 200,
+                        });
+                        const rows = currentWorkstreams &&
+                            typeof currentWorkstreams === "object" &&
+                            Array.isArray(currentWorkstreams.data)
+                            ? currentWorkstreams.data
+                            : [];
+                        for (const row of rows) {
+                            if (!row || typeof row !== "object" || Array.isArray(row))
+                                continue;
+                            const record = row;
+                            const id = pickNonEmptyString(record.id);
+                            if (!id)
+                                continue;
+                            domainBeforeByWorkstreamId.set(id, pickNonEmptyString(record.domain) ?? null);
+                        }
+                    }
+                    catch {
+                        // Best effort snapshot for before/after confirmation.
+                    }
+                }
+                for (const mapping of normalizedMappings) {
+                    const workstreamId = mapping.workstreamId;
+                    const domain = mapping.domain;
+                    const beforeDomain = domainBeforeByWorkstreamId.get(workstreamId) ?? null;
+                    const payload = {
+                        initiative_id: initiativeId,
+                        domain,
+                    };
+                    if (mapping.role !== undefined)
+                        payload.role = mapping.role;
+                    if (mapping.status !== undefined) {
+                        payload.status = mapping.status;
+                    }
+                    else if (normalizedStatus !== undefined) {
+                        payload.status = normalizedStatus;
+                    }
+                    try {
+                        const result = await client.updateEntityDetailed("workstream", workstreamId, payload);
+                        const entityRecord = result.entity && typeof result.entity === "object" && !Array.isArray(result.entity)
+                            ? result.entity
+                            : null;
+                        const reassignmentRecord = result.reassignment &&
+                            typeof result.reassignment === "object" &&
+                            !Array.isArray(result.reassignment)
+                            ? result.reassignment
+                            : null;
+                        const resolvedBeforeDomain = pickNonEmptyString(beforeDomain, reassignmentRecord?.before_domain, reassignmentRecord?.previous_domain, reassignmentRecord?.from_domain, entityRecord?.before_domain, entityRecord?.previous_domain, entityRecord?.from_domain) ?? null;
+                        const afterDomain = pickNonEmptyString(reassignmentRecord?.after_domain, reassignmentRecord?.new_domain, reassignmentRecord?.to_domain, entityRecord?.after_domain, entityRecord?.new_domain, entityRecord?.to_domain, entityRecord?.domain, domain) ?? null;
+                        updates.push({
+                            workstream_id: workstreamId,
+                            domain,
+                            before_domain: resolvedBeforeDomain,
+                            after_domain: afterDomain,
+                            ok: true,
+                            entity: result.entity,
+                            reassignment: result.reassignment ?? null,
+                            initiative_reassignment: result.initiative_reassignment ?? null,
+                        });
+                    }
+                    catch (updateErr) {
+                        updates.push({
+                            workstream_id: workstreamId,
+                            domain,
+                            before_domain: beforeDomain,
+                            after_domain: null,
+                            ok: false,
+                            error: updateErr instanceof Error ? updateErr.message : String(updateErr),
+                        });
+                    }
+                }
+                const succeeded = updates.filter((entry) => entry.ok).length;
+                const failed = updates.length - succeeded;
+                return json(`✅ Reassigned ${succeeded}/${updates.length} workstream(s)`, {
+                    initiative_id: initiativeId,
+                    updated_count: succeeded,
+                    failed_count: failed,
+                    updates,
+                });
+            }
+            catch (err) {
+                return text(`❌ Batch stream reassignment failed: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
     // --- orgx_list_entities ---
     registerMcpTool({
         name: "orgx_list_entities",
@@ -432,6 +1240,22 @@ export function registerCoreTools(deps) {
                     description: "Max results (default 20)",
                     default: 20,
                 },
+                initiative_id: {
+                    type: "string",
+                    description: "Filter by initiative ID",
+                },
+                project_id: {
+                    type: "string",
+                    description: "Legacy project/workspace scope filter",
+                },
+                workspace_id: {
+                    type: "string",
+                    description: "Workspace ID (canonical scope)",
+                },
+                command_center_id: {
+                    type: "string",
+                    description: "Deprecated alias for workspace_id",
+                },
             },
             required: ["type"],
         },
@@ -448,6 +1272,285 @@ export function registerCoreTools(deps) {
             }
         },
     }, { optional: true });
+    function evalGateErrorForPackStatus(status) {
+        if (typeof status !== "string")
+            return null;
+        const normalized = status.trim().toLowerCase();
+        if (!normalized || normalized === "approved")
+            return null;
+        return `SkillPack eval gate blocked activation: status '${status}' is not approved`;
+    }
+    function manifestValidationErrorForPackManifest(manifest) {
+        if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
+            return null;
+        }
+        const validation = validateOpenClawSkillPackManifest(manifest);
+        if (validation.errors.length === 0)
+            return null;
+        return `SkillPack manifest validation errors: ${validation.errors.join("; ")}`;
+    }
+    function computeSkillPackUpdateAvailable(state) {
+        return Boolean(state.remote?.checksum &&
+            state.pack?.checksum &&
+            state.remote.checksum !== state.pack.checksum);
+    }
+    function resolveAgentConfigId(input) {
+        const value = typeof input === "string" ? input.trim() : "";
+        if (!value || value === "default") {
+            return "default";
+        }
+        return null;
+    }
+    function resolveAgentConfigTemplateId(input) {
+        const value = typeof input === "string" ? input.trim().toLowerCase() : "";
+        if (value === "startup-speed") {
+            return "startup-speed";
+        }
+        return null;
+    }
+    function buildAgentConfigSnapshot(state) {
+        return {
+            config_id: "default",
+            config_type: "skill_pack_policy",
+            policy: state.policy,
+            pack: state.pack,
+            remote: state.remote,
+            update_available: computeSkillPackUpdateAvailable(state),
+            last_checked_at: state.lastCheckedAt,
+            last_error: state.lastError,
+            updated_at: state.updatedAt,
+        };
+    }
+    async function readAgentConfigState(input) {
+        const state = readSkillPackState();
+        if (!input?.refreshRemote) {
+            return state;
+        }
+        const getSkillPack = client.getSkillPack;
+        if (typeof getSkillPack !== "function") {
+            return state;
+        }
+        try {
+            const response = await getSkillPack({
+                name: state.pack?.name ?? state.remote?.name ?? "orgx-agent-suite",
+                ifNoneMatch: null,
+            });
+            const checkedAt = new Date().toISOString();
+            if (!response.ok) {
+                return {
+                    ...state,
+                    updatedAt: checkedAt,
+                    lastCheckedAt: checkedAt,
+                    lastError: response.error ?? state.lastError,
+                };
+            }
+            if (response.notModified || !response.pack) {
+                return {
+                    ...state,
+                    updatedAt: checkedAt,
+                    lastCheckedAt: checkedAt,
+                    lastError: null,
+                    etag: response.etag ?? state.etag,
+                };
+            }
+            const remote = {
+                name: response.pack.name,
+                version: response.pack.version,
+                checksum: response.pack.checksum,
+                updated_at: response.pack.updated_at ?? null,
+            };
+            const evalGateError = evalGateErrorForPackStatus(response.pack.status);
+            const manifestValidationError = manifestValidationErrorForPackManifest(response.pack.manifest);
+            const activationValidationError = evalGateError ?? manifestValidationError;
+            const shouldApplyPack = !activationValidationError &&
+                (!state.policy.pinnedChecksum || state.policy.pinnedChecksum === response.pack.checksum);
+            return {
+                ...state,
+                updatedAt: checkedAt,
+                lastCheckedAt: checkedAt,
+                lastError: activationValidationError,
+                etag: response.etag ?? state.etag,
+                remote,
+                pack: shouldApplyPack ? remote : state.pack,
+            };
+        }
+        catch {
+            return state;
+        }
+    }
+    // --- list_agent_configs ---
+    registerMcpTool({
+        name: "list_agent_configs",
+        description: "List available agent behavior configs managed by this plugin.",
+        parameters: {
+            type: "object",
+            properties: {
+                refresh_remote: {
+                    type: "boolean",
+                    description: "When true, re-fetch behavior config policy from OrgX before returning data.",
+                },
+            },
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            try {
+                const state = await readAgentConfigState({
+                    refreshRemote: params.refresh_remote === true,
+                });
+                return json("Agent configs:", {
+                    total: 1,
+                    configs: [buildAgentConfigSnapshot(state)],
+                });
+            }
+            catch (err) {
+                return text(`❌ Failed to list agent configs: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
+    // --- get_agent_config ---
+    registerMcpTool({
+        name: "get_agent_config",
+        description: "Get a single agent behavior config by id (default only).",
+        parameters: {
+            type: "object",
+            properties: {
+                config_id: {
+                    type: "string",
+                    description: "Agent config identifier. Use 'default'.",
+                },
+                refresh_remote: {
+                    type: "boolean",
+                    description: "When true, re-fetch behavior config policy from OrgX before returning data.",
+                },
+            },
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            const configId = resolveAgentConfigId(params.config_id);
+            if (!configId) {
+                return text("❌ config_id must be 'default'.");
+            }
+            try {
+                const state = await readAgentConfigState({
+                    refreshRemote: params.refresh_remote === true,
+                });
+                return json("Agent config:", buildAgentConfigSnapshot(state));
+            }
+            catch (err) {
+                return text(`❌ Failed to read agent config: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
+    // --- update_agent_config ---
+    registerMcpTool({
+        name: "update_agent_config",
+        description: "Update plugin-managed agent behavior config policy (default config only).",
+        parameters: {
+            type: "object",
+            properties: {
+                config_id: {
+                    type: "string",
+                    description: "Agent config identifier. Use 'default'.",
+                },
+                frozen: {
+                    type: "boolean",
+                    description: "Freeze remote skill-pack refresh when true.",
+                },
+                pinned_checksum: {
+                    type: ["string", "null"],
+                    description: "Pin behavior policy to this exact checksum.",
+                },
+                pin_to_current: {
+                    type: "boolean",
+                    description: "Pin to current local/remote checksum.",
+                },
+                clear_pin: {
+                    type: "boolean",
+                    description: "Clear any pinned checksum.",
+                },
+                action: {
+                    type: "string",
+                    description: "Use 'rollback' to revert to the previous config version.",
+                },
+                rollback_to_audit_id: {
+                    type: "string",
+                    description: "Optional audit entry id to rollback to. When omitted with action='rollback', uses the most recent audit entry.",
+                },
+                template_id: {
+                    type: "string",
+                    description: "Optional preset template id. Currently supports 'startup-speed'.",
+                },
+            },
+            additionalProperties: false,
+        },
+        async execute(_callId, params = {}) {
+            const configId = resolveAgentConfigId(params.config_id);
+            if (!configId) {
+                return text("❌ config_id must be 'default'.");
+            }
+            const templateId = resolveAgentConfigTemplateId(params.template_id);
+            if (typeof params.template_id === "string" && !templateId) {
+                return text("❌ template_id must be 'startup-speed' when provided.");
+            }
+            let hasFrozen = typeof params.frozen === "boolean";
+            let hasPinnedChecksum = typeof params.pinned_checksum === "string" || params.pinned_checksum === null;
+            let hasPinToCurrent = params.pin_to_current === true;
+            let hasClearPin = params.clear_pin === true;
+            const action = typeof params.action === "string" ? params.action.trim().toLowerCase() : "";
+            const rollbackToAuditId = typeof params.rollback_to_audit_id === "string" && params.rollback_to_audit_id.trim()
+                ? params.rollback_to_audit_id.trim()
+                : undefined;
+            const isRollback = action === "rollback" || typeof rollbackToAuditId === "string";
+            if (action.length > 0 && action !== "rollback") {
+                return text("❌ action must be 'rollback' when provided.");
+            }
+            if (templateId === "startup-speed") {
+                // Shared default config fans out to all OrgX agent domains.
+                params.frozen = false;
+                params.clear_pin = true;
+                params.pin_to_current = false;
+                params.pinned_checksum = undefined;
+                hasFrozen = true;
+                hasPinnedChecksum = false;
+                hasPinToCurrent = false;
+                hasClearPin = true;
+            }
+            if (isRollback) {
+                if (hasFrozen || hasPinnedChecksum || hasPinToCurrent || hasClearPin || templateId) {
+                    return text("❌ Rollback requests cannot include update fields (frozen, pinned_checksum, pin_to_current, clear_pin, template_id).");
+                }
+            }
+            else if (!hasFrozen && !hasPinnedChecksum && !hasPinToCurrent && !hasClearPin) {
+                return text("❌ Include at least one mutable field: frozen, pinned_checksum, pin_to_current, clear_pin, or template_id.");
+            }
+            if (hasPinToCurrent && hasClearPin) {
+                return text("❌ pin_to_current and clear_pin cannot both be true.");
+            }
+            if (typeof params.pinned_checksum === "string" && !params.pinned_checksum.trim()) {
+                return text("❌ pinned_checksum must be a non-empty string when provided.");
+            }
+            try {
+                const state = isRollback
+                    ? rollbackSkillPackPolicy({
+                        auditId: rollbackToAuditId,
+                    })
+                    : updateSkillPackPolicy({
+                        frozen: hasFrozen ? params.frozen : undefined,
+                        pinnedChecksum: typeof params.pinned_checksum === "string"
+                            ? params.pinned_checksum.trim()
+                            : params.pinned_checksum === null
+                                ? null
+                                : undefined,
+                        pinToCurrent: hasPinToCurrent,
+                        clearPin: hasClearPin,
+                    });
+                return json(isRollback ? "Agent config rolled back:" : "Agent config updated:", buildAgentConfigSnapshot(state));
+            }
+            catch (err) {
+                return text(`❌ Failed to ${isRollback ? "rollback" : "update"} agent config: ${err instanceof Error ? err.message : err}`);
+            }
+        },
+    }, { optional: true });
     function withProvenanceMetadata(metadata) {
         const input = metadata ?? {};
         const out = { ...input };
@@ -490,6 +1593,26 @@ export function registerCoreTools(deps) {
         }
         return out;
     }
+    function deriveAgentIdentity(payload) {
+        const envAgentId = pickNonEmptyString(process.env.ORGX_AGENT_ID) ?? null;
+        const envAgentName = pickNonEmptyString(process.env.ORGX_AGENT_NAME) ?? null;
+        const payloadRecord = payload && typeof payload === "object" && !Array.isArray(payload)
+            ? payload
+            : null;
+        const metadataRaw = payloadRecord?.metadata;
+        const metadata = metadataRaw && typeof metadataRaw === "object" && !Array.isArray(metadataRaw)
+            ? metadataRaw
+            : {};
+        const metadataAgentId = pickNonEmptyString(metadata.agent_id, metadata.agentId, metadata.executor_agent_id, metadata.executorAgentId, metadata.requested_by_agent_id, metadata.requestedByAgentId) ?? null;
+        const metadataAgentName = pickNonEmptyString(metadata.agent_name, metadata.agentName, metadata.executor_agent_name, metadata.executorAgentName, metadata.requested_by_agent_name, metadata.requestedByAgentName) ?? null;
+        return {
+            agentId: envAgentId ?? metadataAgentId,
+            agentName: envAgentName ?? metadataAgentName,
+        };
+    }
+    function deriveCorrelationFromRun(runId) {
+        return `openclaw_run_${runId.replace(/[^a-zA-Z0-9]/g, "").slice(0, 24)}`;
+    }
     async function emitActivityWithFallback(source, payload) {
         if (!payload.message || payload.message.trim().length === 0) {
             return text("❌ message is required");
@@ -500,6 +1623,20 @@ export function registerCoreTools(deps) {
         }
         const now = new Date().toISOString();
         const id = `progress:${randomUUID().slice(0, 8)}`;
+        const envWorkstreamId = pickNonEmptyString(process.env.ORGX_WORKSTREAM_ID);
+        const envTaskId = pickNonEmptyString(process.env.ORGX_TASK_ID);
+        const { agentId, agentName } = deriveAgentIdentity(payload);
+        const canonicalMetadata = {
+            initiative_id: context.value.initiativeId,
+            run_id: context.value.runId ?? null,
+            slice_run_id: context.value.runId ?? null,
+            correlation_id: context.value.correlationId ?? null,
+            source_client: context.value.sourceClient ?? null,
+            ...(envWorkstreamId ? { workstream_id: envWorkstreamId } : {}),
+            ...(envTaskId ? { task_id: envTaskId } : {}),
+            ...(agentId ? { agent_id: agentId } : {}),
+            ...(agentName ? { agent_name: agentName } : {}),
+        };
         const normalizedPayload = {
             initiative_id: context.value.initiativeId,
             run_id: context.value.runId,
@@ -511,6 +1648,7 @@ export function registerCoreTools(deps) {
             level: payload.level ?? "info",
             next_step: payload.next_step,
             metadata: withProvenanceMetadata({
+                ...canonicalMetadata,
                 ...(payload.metadata ?? {}),
                 source,
             }),
@@ -520,12 +1658,12 @@ export function registerCoreTools(deps) {
             type: "delegation",
             title: payload.message,
             description: payload.next_step ?? null,
-            agentId: null,
-            agentName: null,
-            requesterAgentId: null,
-            requesterAgentName: null,
-            executorAgentId: null,
-            executorAgentName: null,
+            agentId,
+            agentName,
+            requesterAgentId: agentId,
+            requesterAgentName: agentName,
+            executorAgentId: agentId,
+            executorAgentName: agentName,
             runId: context.value.runId ?? null,
             initiativeId: context.value.initiativeId,
             timestamp: now,
@@ -537,7 +1675,29 @@ export function registerCoreTools(deps) {
             const result = await client.emitActivity(normalizedPayload);
             return text(`Activity emitted: ${payload.message} [${normalizedPayload.phase}${payload.progress_pct != null ? ` ${payload.progress_pct}%` : ""}] (run ${result.run_id.slice(0, 8)}...)`);
         }
-        catch {
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (normalizedPayload.run_id &&
+                /^404\b/.test(errMsg) &&
+                /\brun\b/i.test(errMsg) &&
+                /not found/i.test(errMsg)) {
+                try {
+                    const retryCorrelation = normalizedPayload.correlation_id ?? deriveCorrelationFromRun(normalizedPayload.run_id);
+                    const retryResult = await client.emitActivity({
+                        ...normalizedPayload,
+                        run_id: undefined,
+                        correlation_id: retryCorrelation,
+                        metadata: withProvenanceMetadata({
+                            ...(normalizedPayload.metadata ?? {}),
+                            replay_run_id_as_correlation: true,
+                        }),
+                    });
+                    return text(`Activity emitted: ${payload.message} [${normalizedPayload.phase}${payload.progress_pct != null ? ` ${payload.progress_pct}%` : ""}] (run ${retryResult.run_id.slice(0, 8)}...)`);
+                }
+                catch {
+                    // Fall through to local outbox buffering.
+                }
+            }
             await appendToOutbox("progress", {
                 id,
                 type: "progress",
@@ -568,17 +1728,18 @@ export function registerCoreTools(deps) {
         };
         const now = new Date().toISOString();
         const id = `changeset:${randomUUID().slice(0, 8)}`;
+        const { agentId, agentName } = deriveAgentIdentity();
         const activityItem = {
             id,
             type: "milestone_completed",
             title: "Changeset queued",
             description: `${payload.operations.length} operation${payload.operations.length === 1 ? "" : "s"}`,
-            agentId: null,
-            agentName: null,
-            requesterAgentId: null,
-            requesterAgentName: null,
-            executorAgentId: null,
-            executorAgentName: null,
+            agentId,
+            agentName,
+            requesterAgentId: agentId,
+            requesterAgentName: agentName,
+            executorAgentId: agentId,
+            executorAgentName: agentName,
             runId: context.value.runId ?? null,
             initiativeId: context.value.initiativeId,
             timestamp: now,
@@ -587,13 +1748,34 @@ export function registerCoreTools(deps) {
             metadata: withProvenanceMetadata({
                 source,
                 idempotency_key: idempotencyKey,
+                run_id: context.value.runId ?? null,
+                correlation_id: context.value.correlationId ?? null,
+                ...(agentId ? { agent_id: agentId } : {}),
+                ...(agentName ? { agent_name: agentName } : {}),
             }),
         };
         try {
             const result = await client.applyChangeset(requestPayload);
             return text(`Changeset ${result.replayed ? "replayed" : "applied"}: ${result.applied_count} op${result.applied_count === 1 ? "" : "s"} (run ${result.run_id.slice(0, 8)}...)`);
         }
-        catch {
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (requestPayload.run_id &&
+                /^404\b/.test(errMsg) &&
+                /\brun\b/i.test(errMsg) &&
+                /not found/i.test(errMsg)) {
+                try {
+                    const retryResult = await client.applyChangeset({
+                        ...requestPayload,
+                        run_id: undefined,
+                        correlation_id: requestPayload.correlation_id ?? deriveCorrelationFromRun(requestPayload.run_id),
+                    });
+                    return text(`Changeset ${retryResult.replayed ? "replayed" : "applied"}: ${retryResult.applied_count} op${retryResult.applied_count === 1 ? "" : "s"} (run ${retryResult.run_id.slice(0, 8)}...)`);
+                }
+                catch {
+                    // Fall through to local outbox buffering.
+                }
+            }
             await appendToOutbox("decisions", {
                 id,
                 type: "changeset",
@@ -770,6 +1952,69 @@ export function registerCoreTools(deps) {
             });
         },
     }, { optional: true });
+    // --- update_stream_progress (legacy alias -> orgx_report_progress) ---
+    registerMcpTool({
+        name: "update_stream_progress",
+        description: "Legacy alias for orgx_report_progress. Report progress at key milestones so the team can track your work.",
+        parameters: {
+            type: "object",
+            properties: {
+                initiative_id: {
+                    type: "string",
+                    description: "Initiative UUID (required unless ORGX_INITIATIVE_ID is set)",
+                },
+                run_id: {
+                    type: "string",
+                    description: "Optional run UUID",
+                },
+                correlation_id: {
+                    type: "string",
+                    description: "Required when run_id is omitted",
+                },
+                source_client: {
+                    type: "string",
+                    enum: ["openclaw", "codex", "claude-code", "api"],
+                },
+                summary: {
+                    type: "string",
+                    description: "What was accomplished (1-2 sentences, human-readable)",
+                },
+                phase: {
+                    type: "string",
+                    enum: ["researching", "implementing", "testing", "reviewing", "blocked"],
+                    description: "Current work phase",
+                },
+                progress_pct: {
+                    type: "number",
+                    description: "Progress percentage (0-100)",
+                    minimum: 0,
+                    maximum: 100,
+                },
+                next_step: {
+                    type: "string",
+                    description: "What you plan to do next",
+                },
+            },
+            required: ["summary", "phase"],
+            additionalProperties: false,
+        },
+        async execute(_callId, params = { summary: "", phase: "implementing" }) {
+            return emitActivityWithFallback("update_stream_progress", {
+                initiative_id: params.initiative_id,
+                run_id: params.run_id,
+                correlation_id: params.correlation_id,
+                source_client: params.source_client,
+                message: params.summary,
+                phase: toReportingPhase(params.phase, params.progress_pct),
+                progress_pct: params.progress_pct,
+                next_step: params.next_step,
+                level: params.phase === "blocked" ? "warn" : "info",
+                metadata: {
+                    legacy_phase: params.phase,
+                },
+            });
+        },
+    }, { optional: true });
     // --- orgx_request_decision (alias -> orgx_apply_changeset decision.create) ---
     registerMcpTool({
         name: "orgx_request_decision",
@@ -883,6 +2128,12 @@ export function registerCoreTools(deps) {
                     type: "string",
                     description: "Artifact type code (e.g., 'eng.diff_pack', 'pr', 'document'). Falls back to 'shared.project_handbook' if the type is not recognized by OrgX.",
                 },
+                confidence_score: {
+                    type: "number",
+                    minimum: 0,
+                    maximum: 1,
+                    description: "Self-assessed confidence for this artifact in [0,1].",
+                },
                 description: {
                     type: "string",
                     description: "What this artifact is and why it matters",
@@ -926,19 +2177,27 @@ export function registerCoreTools(deps) {
             if (!params.url && !params.content) {
                 return text("❌ Cannot register artifact: provide at least one of url or content.");
             }
+            if (typeof params.confidence_score !== "undefined" &&
+                (!Number.isFinite(params.confidence_score) ||
+                    params.confidence_score < 0 ||
+                    params.confidence_score > 1)) {
+                return text("❌ Cannot register artifact: confidence_score must be a number between 0 and 1.");
+            }
+            const confidenceScore = typeof params.confidence_score === "number" ? params.confidence_score : null;
             const baseUrl = client.getBaseUrl();
             const artifactId = randomUUID();
+            const { agentId, agentName } = deriveAgentIdentity(params);
             const activityItem = {
                 id,
                 type: "artifact_created",
                 title: params.name,
                 description: params.description ?? null,
-                agentId: null,
-                agentName: null,
-                requesterAgentId: null,
-                requesterAgentName: null,
-                executorAgentId: null,
-                executorAgentName: null,
+                agentId,
+                agentName,
+                requesterAgentId: agentId,
+                requesterAgentName: agentName,
+                executorAgentId: agentId,
+                executorAgentName: agentName,
                 runId: null,
                 initiativeId: resolvedEntityType === "initiative" ? resolvedEntityId : null,
                 timestamp: now,
@@ -946,9 +2205,12 @@ export function registerCoreTools(deps) {
                 metadata: withProvenanceMetadata({
                     source: "orgx_register_artifact",
                     artifact_type: params.artifact_type,
+                    confidence_score: confidenceScore,
                     url: params.url,
                     entity_type: resolvedEntityType,
                     entity_id: resolvedEntityId,
+                    ...(agentId ? { agent_id: agentId } : {}),
+                    ...(agentName ? { agent_name: agentName } : {}),
                 }),
             };
             try {
@@ -958,6 +2220,7 @@ export function registerCoreTools(deps) {
                     entity_id: resolvedEntityId,
                     name: params.name,
                     artifact_type: params.artifact_type,
+                    confidence_score: confidenceScore,
                     description: params.description ?? null,
                     external_url: params.url ?? null,
                     preview_markdown: params.content ?? null,
@@ -965,6 +2228,7 @@ export function registerCoreTools(deps) {
                     metadata: {
                         source: "orgx_register_artifact",
                         artifact_id: artifactId,
+                        confidence_score: confidenceScore,
                     },
                     validate_persistence: true,
                 });
@@ -989,6 +2253,7 @@ export function registerCoreTools(deps) {
                         artifact_id: artifactId,
                         name: params.name,
                         artifact_type: params.artifact_type,
+                        confidence_score: confidenceScore,
                         description: params.description,
                         url: params.url,
                         content: params.content,