@wrongstack/webui-server 0.284.0

package/dist/server/handlers.d.ts

@@ -0,0 +1,51 @@
+import { WebSocket } from 'ws';
+import { TodoItem } from '@wrongstack/core';
+
+interface WorklistContext {
+    context: {
+        todos: TodoItem[];
+        meta: Record<string, unknown>;
+        session: {
+            id: string;
+        } | null;
+        state?: unknown;
+    };
+    send: (ws: WebSocket, msg: object) => void;
+    broadcast: (msg: object) => void;
+    /**
+     * Optional mutator for in-memory todo state. Servers that manage live
+     * agent state (e.g. the CLI embedded server) provide this so handlers
+     * can update the agent's todo list directly. Standalone server may omit.
+     */
+    replaceTodos?: (todos: TodoItem[]) => void;
+}
+declare function handleTodosGet(ctx: WorklistContext, ws: WebSocket): void;
+declare function handleTodosClear(ctx: WorklistContext, ws: WebSocket): void;
+declare function handleTodosRemove(ctx: WorklistContext, ws: WebSocket, payload: {
+    id?: string;
+    index?: number;
+} | undefined): void;
+declare function handleTodoUpdate(ctx: WorklistContext, ws: WebSocket, payload: {
+    id: string;
+    status?: TodoItem['status'];
+    activeForm?: string;
+}): void;
+declare function handleTasksGet(ctx: WorklistContext, ws: WebSocket): Promise<void>;
+declare function handleTaskUpdate(ctx: WorklistContext, ws: WebSocket, payload: {
+    id: string;
+    status: 'pending' | 'in_progress' | 'blocked' | 'failed' | 'review' | 'completed';
+}): Promise<void>;
+declare function handlePlanGet(ctx: WorklistContext, ws: WebSocket): Promise<void>;
+declare function handlePlanTemplateUse(ctx: WorklistContext, ws: WebSocket, template: string): Promise<void>;
+declare function handlePlanItemUpdate(ctx: WorklistContext, ws: WebSocket, payload: {
+    target: string;
+    status: 'open' | 'in_progress' | 'done';
+}): Promise<void>;
+/** Loosely-typed worklist WS message — payload shapes are narrowed per case. */
+interface WorklistMessage {
+    type: string;
+    payload?: unknown;
+}
+declare function handleWorklistMessage(ctx: WorklistContext, ws: WebSocket, msg: WorklistMessage): Promise<void>;
+
+export { type WorklistContext, type WorklistMessage, handlePlanGet, handlePlanItemUpdate, handlePlanTemplateUse, handleTaskUpdate, handleTasksGet, handleTodoUpdate, handleTodosClear, handleTodosGet, handleTodosRemove, handleWorklistMessage };

package/dist/server/handlers.js

@@ -0,0 +1,249 @@
+// src/server/ws-payload-validation.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validatePlanTemplateUsePayload(payload) {
+  if (!isRecord(payload)) {
+    return {
+      ok: false,
+      message: "plan.template_use payload must be an object with string template"
+    };
+  }
+  const template = payload["template"];
+  if (typeof template !== "string" || template.trim().length === 0) {
+    return { ok: false, message: "plan.template_use payload.template must be a non-empty string" };
+  }
+  return { ok: true, value: { template } };
+}
+
+// src/server/handlers/worklist-handlers.ts
+function sendResult(ws, ctx, ok, message) {
+  ctx.send(ws, { type: ok ? "ok" : "error", message });
+}
+function sessionPayload(ctx, payload) {
+  const provided = payload["sessionId"];
+  const fallback = ctx.context.session?.id ?? "";
+  const sessionId = typeof provided === "string" && provided.length > 0 ? provided : fallback;
+  return { ...payload, sessionId };
+}
+function handleTodosGet(ctx, ws) {
+  ctx.send(ws, { type: "todos.updated", payload: sessionPayload(ctx, { todos: ctx.context.todos }) });
+}
+function handleTodosClear(ctx, ws) {
+  ctx.replaceTodos?.([]);
+  ctx.broadcast({ type: "todos.cleared", payload: sessionPayload(ctx, {}) });
+  sendResult(ws, ctx, true, "Todo board cleared.");
+}
+function handleTodosRemove(ctx, ws, payload) {
+  if (!payload || payload.id === void 0 && payload.index === void 0) {
+    sendResult(ws, ctx, false, "todos.remove requires id or index.");
+    return;
+  }
+  const next = payload.id !== void 0 ? ctx.context.todos.filter((t) => t.id !== payload.id) : ctx.context.todos.filter((_, i) => i !== payload.index);
+  ctx.replaceTodos?.(next);
+  ctx.broadcast({ type: "todos.updated", payload: sessionPayload(ctx, { todos: next }) });
+  sendResult(ws, ctx, true, "Todo item removed.");
+}
+function handleTodoUpdate(ctx, ws, payload) {
+  const todo = ctx.context.todos.find((t) => t.id === payload.id);
+  if (!todo) {
+    sendResult(ws, ctx, false, `No todo with id "${payload.id}".`);
+    return;
+  }
+  const next = ctx.context.todos.map(
+    (t) => t.id === payload.id ? { ...t, ...payload.status !== void 0 && { status: payload.status }, ...payload.activeForm !== void 0 && { activeForm: payload.activeForm } } : t
+  );
+  ctx.replaceTodos?.(next);
+  ctx.broadcast({ type: "todos.updated", payload: sessionPayload(ctx, { todos: next }) });
+  sendResult(ws, ctx, true, `Todo "${todo.content}" updated.`);
+}
+async function handleTasksGet(ctx, ws) {
+  const taskPath = ctx.context.meta["task.path"];
+  if (typeof taskPath === "string" && taskPath) {
+    try {
+      const { loadTasks } = await import('@wrongstack/core');
+      const file = await loadTasks(taskPath);
+      ctx.send(ws, { type: "tasks.updated", payload: sessionPayload(ctx, { tasks: file?.tasks ?? [] }) });
+    } catch {
+      ctx.send(ws, { type: "tasks.updated", payload: sessionPayload(ctx, { tasks: [] }) });
+    }
+  } else {
+    ctx.send(ws, {
+      type: "tasks.updated",
+      payload: sessionPayload(ctx, { tasks: [], error: "Task storage not configured." })
+    });
+  }
+}
+async function handleTaskUpdate(ctx, ws, payload) {
+  const taskPath = ctx.context.meta["task.path"];
+  if (typeof taskPath !== "string" || !taskPath) {
+    sendResult(ws, ctx, false, "Task storage is not configured for this session.");
+    return;
+  }
+  try {
+    const { loadTasks, saveTasks } = await import('@wrongstack/core');
+    const file = await loadTasks(taskPath);
+    if (!file) {
+      sendResult(ws, ctx, false, "No task file found.");
+      return;
+    }
+    const idx = file.tasks.findIndex((t) => t.id === payload.id);
+    if (idx === -1) {
+      sendResult(ws, ctx, false, `Task "${payload.id}" not found.`);
+      return;
+    }
+    const existing = file.tasks[idx];
+    if (!existing) {
+      sendResult(ws, ctx, false, `Task "${payload.id}" not found.`);
+      return;
+    }
+    file.tasks[idx] = { ...existing, status: payload.status };
+    await saveTasks(taskPath, file);
+    ctx.broadcast({ type: "tasks.updated", payload: sessionPayload(ctx, { tasks: file.tasks }) });
+    sendResult(ws, ctx, true, `Task "${payload.id}" marked ${payload.status}.`);
+  } catch (err) {
+    sendResult(ws, ctx, false, String(err));
+  }
+}
+async function handlePlanGet(ctx, ws) {
+  const planPath = ctx.context.meta["plan.path"];
+  const sessionId = ctx.context.session?.id ?? "";
+  if (typeof planPath === "string" && planPath) {
+    try {
+      const { loadPlan } = await import('@wrongstack/core');
+      const plan = await loadPlan(planPath);
+      ctx.send(ws, {
+        type: "plan.updated",
+        payload: sessionPayload(ctx, {
+          plan: plan ?? {
+            version: 1,
+            sessionId,
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            items: []
+          }
+        })
+      });
+    } catch {
+      ctx.send(ws, {
+        type: "plan.updated",
+        payload: sessionPayload(ctx, {
+          plan: {
+            version: 1,
+            sessionId,
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            items: []
+          }
+        })
+      });
+    }
+  } else {
+    ctx.send(ws, {
+      type: "plan.updated",
+      payload: sessionPayload(ctx, { plan: null, error: "Plan storage is not configured for this session." })
+    });
+  }
+}
+async function handlePlanTemplateUse(ctx, ws, template) {
+  const planPath = ctx.context.meta["plan.path"];
+  const sessionId = ctx.context.session?.id ?? "";
+  if (typeof planPath !== "string" || !planPath) {
+    sendResult(ws, ctx, false, "Plan storage is not configured for this session.");
+    return;
+  }
+  try {
+    const { getPlanTemplate, loadPlan, savePlan, emptyPlan, addPlanItem } = await import('@wrongstack/core');
+    const tpl = getPlanTemplate(template);
+    if (!tpl) {
+      sendResult(ws, ctx, false, `Unknown template "${template}".`);
+      return;
+    }
+    let plan = await loadPlan(planPath) ?? emptyPlan(sessionId);
+    for (const item of tpl.items) {
+      ({ plan } = addPlanItem(plan, item.title, item.details));
+    }
+    await savePlan(planPath, plan);
+    sendResult(ws, ctx, true, `Applied template "${tpl.name}" \u2014 ${tpl.items.length} items added.`);
+    ctx.broadcast({ type: "plan.updated", payload: sessionPayload(ctx, { plan }) });
+  } catch (err) {
+    sendResult(ws, ctx, false, String(err));
+  }
+}
+async function handlePlanItemUpdate(ctx, ws, payload) {
+  const planPath = ctx.context.meta["plan.path"];
+  const sessionId = ctx.context.session?.id ?? "";
+  if (typeof planPath !== "string" || !planPath) {
+    sendResult(ws, ctx, false, "Plan storage is not configured for this session.");
+    return;
+  }
+  try {
+    const { mutatePlan, setPlanItemStatus } = await import('@wrongstack/core');
+    let changed = false;
+    const plan = await mutatePlan(planPath, sessionId, async (p) => {
+      const before = p.updatedAt;
+      const updated = setPlanItemStatus(p, payload.target, payload.status);
+      changed = updated.updatedAt !== before;
+      return updated;
+    });
+    if (!changed) {
+      sendResult(ws, ctx, false, `No plan item matched "${payload.target}".`);
+      return;
+    }
+    sendResult(ws, ctx, true, `Plan item status updated to "${payload.status}".`);
+    ctx.broadcast({ type: "plan.updated", payload: sessionPayload(ctx, { plan }) });
+  } catch (err) {
+    sendResult(ws, ctx, false, String(err));
+  }
+}
+async function handleWorklistMessage(ctx, ws, msg) {
+  switch (msg.type) {
+    case "todos.get":
+      handleTodosGet(ctx, ws);
+      return;
+    case "todos.clear":
+      handleTodosClear(ctx, ws);
+      return;
+    case "todos.remove":
+      handleTodosRemove(ctx, ws, msg.payload);
+      return;
+    case "todo.update":
+      handleTodoUpdate(
+        ctx,
+        ws,
+        msg.payload
+      );
+      return;
+    case "tasks.get":
+      await handleTasksGet(ctx, ws);
+      return;
+    case "task.update":
+      await handleTaskUpdate(
+        ctx,
+        ws,
+        msg.payload
+      );
+      return;
+    case "plan.get":
+      await handlePlanGet(ctx, ws);
+      return;
+    case "plan.template_use": {
+      const parsed = validatePlanTemplateUsePayload(msg.payload);
+      if (!parsed.ok) {
+        sendResult(ws, ctx, false, parsed.message);
+        return;
+      }
+      await handlePlanTemplateUse(ctx, ws, parsed.value.template);
+      return;
+    }
+    case "plan.item.update":
+      await handlePlanItemUpdate(
+        ctx,
+        ws,
+        msg.payload
+      );
+      return;
+  }
+}
+
+export { handlePlanGet, handlePlanItemUpdate, handlePlanTemplateUse, handleTaskUpdate, handleTasksGet, handleTodoUpdate, handleTodosClear, handleTodosGet, handleTodosRemove, handleWorklistMessage };
+//# sourceMappingURL=handlers.js.map
+//# sourceMappingURL=handlers.js.map

package/dist/server/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/ws-payload-validation.ts","../../src/server/handlers/worklist-handlers.ts"],"names":[],"mappings":"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","file":"handlers.js","sourcesContent":["export type PayloadValidationResult<T> = { ok: true; value: T } | { ok: false; message: string };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport interface ModelSwitchPayload {\n  provider: string;\n  model: string;\n}\n\nexport function validateModelSwitchPayload(\n  payload: unknown,\n): PayloadValidationResult<ModelSwitchPayload> {\n  if (!isRecord(payload)) {\n    return {\n      ok: false,\n      message: 'model.switch payload must be an object with string provider and model',\n    };\n  }\n  const provider = payload['provider'];\n  const model = payload['model'];\n  if (typeof provider !== 'string' || provider.trim().length === 0) {\n    return { ok: false, message: 'model.switch payload.provider must be a non-empty string' };\n  }\n  if (typeof model !== 'string' || model.trim().length === 0) {\n    return { ok: false, message: 'model.switch payload.model must be a non-empty string' };\n  }\n  return { ok: true, value: { provider, model } };\n}\n\nexport interface PrefsUpdatePayload {\n  prefs: Record<string, unknown>;\n}\n\nconst AUTONOMY_VALUES = new Set(['off', 'suggest', 'auto', 'eternal', 'eternal-parallel']);\n\nexport interface MailboxMessagesPayload {\n  limit?: number;\n  agentId?: string;\n  unreadOnly?: boolean;\n  incompleteOnly?: boolean;\n}\n\nexport function validateMailboxMessagesPayload(\n  payload: unknown,\n): PayloadValidationResult<MailboxMessagesPayload | undefined> {\n  if (payload === undefined) return { ok: true, value: undefined };\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'mailbox.messages payload must be an object when provided' };\n  }\n  const limit = payload['limit'];\n  const agentId = payload['agentId'];\n  const unreadOnly = payload['unreadOnly'];\n  const incompleteOnly = payload['incompleteOnly'];\n  if (limit !== undefined && (typeof limit !== 'number' || !Number.isFinite(limit) || limit < 1)) {\n    return {\n      ok: false,\n      message: 'mailbox.messages payload.limit must be a positive number when provided',\n    };\n  }\n  if (agentId !== undefined && typeof agentId !== 'string') {\n    return {\n      ok: false,\n      message: 'mailbox.messages payload.agentId must be a string when provided',\n    };\n  }\n  if (unreadOnly !== undefined && typeof unreadOnly !== 'boolean') {\n    return {\n      ok: false,\n      message: 'mailbox.messages payload.unreadOnly must be a boolean when provided',\n    };\n  }\n  if (incompleteOnly !== undefined && typeof incompleteOnly !== 'boolean') {\n    return {\n      ok: false,\n      message: 'mailbox.messages payload.incompleteOnly must be a boolean when provided',\n    };\n  }\n  return {\n    ok: true,\n    value: {\n      ...(limit !== undefined ? { limit: limit as number } : {}),\n      ...(agentId !== undefined ? { agentId: agentId as string } : {}),\n      ...(unreadOnly !== undefined ? { unreadOnly: unreadOnly as boolean } : {}),\n      ...(incompleteOnly !== undefined ? { incompleteOnly: incompleteOnly as boolean } : {}),\n    },\n  };\n}\n\nexport interface MailboxAgentsPayload {\n  onlineOnly?: boolean;\n}\n\nexport function validateMailboxAgentsPayload(\n  payload: unknown,\n): PayloadValidationResult<MailboxAgentsPayload | undefined> {\n  if (payload === undefined) return { ok: true, value: undefined };\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'mailbox.agents payload must be an object when provided' };\n  }\n  const onlineOnly = payload['onlineOnly'];\n  if (onlineOnly !== undefined && typeof onlineOnly !== 'boolean') {\n    return {\n      ok: false,\n      message: 'mailbox.agents payload.onlineOnly must be a boolean when provided',\n    };\n  }\n  return {\n    ok: true,\n    value: { ...(onlineOnly !== undefined ? { onlineOnly: onlineOnly as boolean } : {}) },\n  };\n}\n\nexport interface MailboxPurgePayload {\n  completedMaxAgeMs?: number;\n  incompleteMaxAgeMs?: number;\n}\n\nexport function validateMailboxPurgePayload(\n  payload: unknown,\n): PayloadValidationResult<MailboxPurgePayload | undefined> {\n  if (payload === undefined) return { ok: true, value: undefined };\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'mailbox.purge payload must be an object when provided' };\n  }\n  const completedMaxAgeMs = payload['completedMaxAgeMs'];\n  const incompleteMaxAgeMs = payload['incompleteMaxAgeMs'];\n  if (\n    completedMaxAgeMs !== undefined &&\n    (typeof completedMaxAgeMs !== 'number' ||\n      !Number.isFinite(completedMaxAgeMs) ||\n      completedMaxAgeMs < 0)\n  ) {\n    return {\n      ok: false,\n      message:\n        'mailbox.purge payload.completedMaxAgeMs must be a non-negative number when provided',\n    };\n  }\n  if (\n    incompleteMaxAgeMs !== undefined &&\n    (typeof incompleteMaxAgeMs !== 'number' ||\n      !Number.isFinite(incompleteMaxAgeMs) ||\n      incompleteMaxAgeMs < 0)\n  ) {\n    return {\n      ok: false,\n      message:\n        'mailbox.purge payload.incompleteMaxAgeMs must be a non-negative number when provided',\n    };\n  }\n  return {\n    ok: true,\n    value: {\n      ...(completedMaxAgeMs !== undefined ? { completedMaxAgeMs: completedMaxAgeMs as number } : {}),\n      ...(incompleteMaxAgeMs !== undefined\n        ? { incompleteMaxAgeMs: incompleteMaxAgeMs as number }\n        : {}),\n    },\n  };\n}\n\nexport interface BrainRiskPayload {\n  level: string;\n}\n\nconst BRAIN_RISK_VALUES = new Set(['off', 'low', 'medium', 'high', 'all']);\n\nexport function validateBrainRiskPayload(\n  payload: unknown,\n): PayloadValidationResult<BrainRiskPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'brain.risk payload must be an object with string level' };\n  }\n  const level = payload['level'];\n  if (typeof level !== 'string' || !BRAIN_RISK_VALUES.has(level)) {\n    return {\n      ok: false,\n      message: 'brain.risk payload.level must be one of off, low, medium, high, all',\n    };\n  }\n  return { ok: true, value: { level } };\n}\n\nexport interface BrainAskPayload {\n  question: string;\n}\n\nexport function validateBrainAskPayload(\n  payload: unknown,\n): PayloadValidationResult<BrainAskPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'brain.ask payload must be an object with string question' };\n  }\n  const question = payload['question'];\n  if (typeof question !== 'string' || question.trim().length === 0) {\n    return { ok: false, message: 'brain.ask payload.question must be a non-empty string' };\n  }\n  return { ok: true, value: { question: question.trim() } };\n}\n\nexport interface AutonomySwitchPayload {\n  mode: string;\n}\n\nexport function validateAutonomySwitchPayload(\n  payload: unknown,\n): PayloadValidationResult<AutonomySwitchPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'autonomy.switch payload must be an object with string mode' };\n  }\n  const mode = payload['mode'];\n  if (typeof mode !== 'string' || !AUTONOMY_VALUES.has(mode)) {\n    return { ok: false, message: 'autonomy.switch payload.mode must be a valid autonomy mode' };\n  }\n  return { ok: true, value: { mode } };\n}\n\nexport interface PlanTemplateUsePayload {\n  template: string;\n}\n\nexport function validatePlanTemplateUsePayload(\n  payload: unknown,\n): PayloadValidationResult<PlanTemplateUsePayload> {\n  if (!isRecord(payload)) {\n    return {\n      ok: false,\n      message: 'plan.template_use payload must be an object with string template',\n    };\n  }\n  const template = payload['template'];\n  if (typeof template !== 'string' || template.trim().length === 0) {\n    return { ok: false, message: 'plan.template_use payload.template must be a non-empty string' };\n  }\n  return { ok: true, value: { template } };\n}\nconst CONTEXT_STRATEGY_VALUES = new Set(['hybrid', 'intelligent', 'selective']);\nconst CONTEXT_MODE_VALUES = new Set(['balanced', 'frugal', 'deep', 'archival']);\nconst TOKEN_SAVING_TIER_VALUES = new Set(['off', 'minimal', 'light', 'medium', 'aggressive']);\nconst ENHANCE_LANGUAGE_VALUES = new Set(['original', 'english']);\nconst LOG_LEVEL_VALUES = new Set(['debug', 'info', 'warn', 'error']);\nconst AUDIT_LEVEL_VALUES = new Set(['minimal', 'standard', 'full']);\nconst REASONING_MODE_VALUES = new Set(['auto', 'on', 'off']);\nconst REASONING_EFFORT_VALUES = new Set([\n  'none',\n  'minimal',\n  'low',\n  'medium',\n  'high',\n  'xhigh',\n  'max',\n]);\nconst CACHE_TTL_VALUES = new Set(['default', '5m', '1h']);\n\nconst BOOLEAN_PREF_KEYS = new Set([\n  'yolo',\n  'chime',\n  'confirmExit',\n  'streamFleet',\n  'nextPrediction',\n  'titleAnimation',\n  'enhanceEnabled',\n  'featureMcp',\n  'featurePlugins',\n  'featureMemory',\n  'featureSkills',\n  'featureModelsRegistry',\n  'indexOnStart',\n  'contextAutoCompact',\n  'tgSessionEnd',\n  'tgDelegate',\n  'reasoningPreserve',\n  'hqEnabled',\n  'hqRawContent',\n  'fallbackAuto',\n  'favoriteModelsOnly',\n]);\n\n/** Keys whose value must be an array of strings (e.g. an ordered model list). */\nconst STRING_ARRAY_PREF_KEYS = new Set(['fallbackModels', 'favoriteModels']);\nconst STRING_ARRAY_RECORD_PREF_KEYS = new Set(['fallbackProfiles']);\nconst MODEL_MATRIX_PREF_KEYS = new Set(['modelMatrix']);\n\nconst NUMBER_PREF_KEYS = new Set([\n  'autonomyDelayMs',\n  'autoProceedMaxIterations',\n  'maxIterations',\n  'maxConcurrent',\n  'enhanceDelayMs',\n  'tgLongToolMs',\n]);\n\nconst STRING_PREF_KEYS = new Set(['hqUrl', 'hqToken', 'uiLocale']);\n\nconst ENUM_PREF_KEYS: Record<string, Set<string>> = {\n  autonomy: AUTONOMY_VALUES,\n  contextStrategy: CONTEXT_STRATEGY_VALUES,\n  contextMode: CONTEXT_MODE_VALUES,\n  tokenSavingTier: TOKEN_SAVING_TIER_VALUES,\n  enhanceLanguage: ENHANCE_LANGUAGE_VALUES,\n  logLevel: LOG_LEVEL_VALUES,\n  auditLevel: AUDIT_LEVEL_VALUES,\n  reasoningMode: REASONING_MODE_VALUES,\n  reasoningEffort: REASONING_EFFORT_VALUES,\n  cacheTtl: CACHE_TTL_VALUES,\n};\n\nfunction validateModelRuntimeValue(modelRuntime: Record<string, unknown>, path: string): string | null {\n  const reasoning = modelRuntime['reasoning'];\n  if (reasoning !== undefined) {\n    if (!isRecord(reasoning)) return `${path}.reasoning must be an object when provided`;\n    const mode = reasoning['mode'];\n    const effort = reasoning['effort'];\n    const preserve = reasoning['preserve'];\n    if (mode !== undefined && (typeof mode !== 'string' || !REASONING_MODE_VALUES.has(mode))) {\n      return `${path}.reasoning.mode must be one of: ${Array.from(REASONING_MODE_VALUES).join(', ')}`;\n    }\n    if (effort !== undefined && (typeof effort !== 'string' || !REASONING_EFFORT_VALUES.has(effort))) {\n      return `${path}.reasoning.effort must be one of: ${Array.from(REASONING_EFFORT_VALUES).join(', ')}`;\n    }\n    if (preserve !== undefined && typeof preserve !== 'boolean') {\n      return `${path}.reasoning.preserve must be a boolean when provided`;\n    }\n  }\n\n  const cache = modelRuntime['cache'];\n  if (cache !== undefined) {\n    if (!isRecord(cache)) return `${path}.cache must be an object when provided`;\n    const ttl = cache['ttl'];\n    if (ttl !== undefined && (typeof ttl !== 'string' || !CACHE_TTL_VALUES.has(ttl) || ttl === 'default')) {\n      return `${path}.cache.ttl must be one of: 5m, 1h`;\n    }\n  }\n\n  const parameters = modelRuntime['parameters'];\n  if (parameters !== undefined && !isRecord(parameters)) {\n    return `${path}.parameters must be an object when provided`;\n  }\n\n  return null;\n}\n\nfunction validatePreferenceValue(key: string, value: unknown): string | null {\n  if (BOOLEAN_PREF_KEYS.has(key)) {\n    return typeof value === 'boolean' ? null : `prefs.update payload.${key} must be a boolean`;\n  }\n  if (NUMBER_PREF_KEYS.has(key)) {\n    return typeof value === 'number' && Number.isFinite(value)\n      ? null\n      : `prefs.update payload.${key} must be a finite number`;\n  }\n  if (STRING_PREF_KEYS.has(key)) {\n    return typeof value === 'string' ? null : `prefs.update payload.${key} must be a string`;\n  }\n  if (STRING_ARRAY_PREF_KEYS.has(key)) {\n    return Array.isArray(value) && value.every((v) => typeof v === 'string')\n      ? null\n      : `prefs.update payload.${key} must be an array of strings`;\n  }\n  if (STRING_ARRAY_RECORD_PREF_KEYS.has(key)) {\n    return isRecord(value) &&\n      Object.values(value).every(\n        (v) => Array.isArray(v) && v.every((item) => typeof item === 'string'),\n      )\n      ? null\n      : `prefs.update payload.${key} must be an object of string arrays`;\n  }\n  if (MODEL_MATRIX_PREF_KEYS.has(key)) {\n    if (!isRecord(value)) return `prefs.update payload.${key} must be an object`;\n    for (const entry of Object.values(value)) {\n      if (!isRecord(entry)) return `prefs.update payload.${key} entries must be objects`;\n      const provider = entry['provider'];\n      const model = entry['model'];\n      const fallbackProfile = entry['fallbackProfile'];\n      const modelRuntime = entry['modelRuntime'];\n      if (provider !== undefined && typeof provider !== 'string') {\n        return `prefs.update payload.${key}.provider must be a string when provided`;\n      }\n      if (model !== undefined && typeof model !== 'string') {\n        return `prefs.update payload.${key}.model must be a string when provided`;\n      }\n      if (fallbackProfile !== undefined && typeof fallbackProfile !== 'string') {\n        return `prefs.update payload.${key}.fallbackProfile must be a string when provided`;\n      }\n      if (modelRuntime !== undefined && !isRecord(modelRuntime)) {\n        return `prefs.update payload.${key}.modelRuntime must be an object when provided`;\n      }\n      if (isRecord(modelRuntime)) {\n        const runtimeError = validateModelRuntimeValue(modelRuntime, `prefs.update payload.${key}.modelRuntime`);\n        if (runtimeError) return runtimeError;\n      }\n      if (model === undefined && fallbackProfile === undefined && modelRuntime === undefined) {\n        return `prefs.update payload.${key} entries require model, fallbackProfile, or modelRuntime`;\n      }\n    }\n    return null;\n  }\n  const allowed = ENUM_PREF_KEYS[key];\n  if (allowed) {\n    return typeof value === 'string' && allowed.has(value)\n      ? null\n      : `prefs.update payload.${key} must be one of: ${Array.from(allowed).join(', ')}`;\n  }\n  return `prefs.update payload contains unknown preference key: ${key}`;\n}\n\nexport function validatePrefsUpdatePayload(\n  payload: unknown,\n): PayloadValidationResult<PrefsUpdatePayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'prefs.update payload must be an object' };\n  }\n  for (const [key, value] of Object.entries(payload)) {\n    const error = validatePreferenceValue(key, value);\n    if (error) return { ok: false, message: error };\n  }\n  return { ok: true, value: { prefs: payload } };\n}\n\nexport interface SkillsCreatePayload {\n  name: string;\n  description: string;\n  scope: 'project' | 'global';\n}\n\nexport function validateSkillsCreatePayload(\n  payload: unknown,\n): PayloadValidationResult<SkillsCreatePayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'skills.create payload must be an object' };\n  }\n  const name = payload['name'];\n  const description = payload['description'];\n  const scope = payload['scope'];\n  if (typeof name !== 'string' || name.trim().length === 0) {\n    return { ok: false, message: 'Skill name is required' };\n  }\n  if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(name.trim())) {\n    return { ok: false, message: 'Skill name must be kebab-case (e.g. my-new-skill)' };\n  }\n  if (typeof description !== 'string' || description.trim().length === 0) {\n    return { ok: false, message: 'Description/trigger is required' };\n  }\n  if (scope !== 'project' && scope !== 'global') {\n    return { ok: false, message: 'skills.create payload.scope must be project or global' };\n  }\n  return { ok: true, value: { name, description, scope } };\n}\n\nexport interface SkillsEditPayload {\n  name: string;\n  body: string;\n}\n\nexport function validateSkillsEditPayload(\n  payload: unknown,\n): PayloadValidationResult<SkillsEditPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'skills.edit payload must be an object' };\n  }\n  const name = payload['name'];\n  const body = payload['body'];\n  if (typeof name !== 'string' || name.trim().length === 0) {\n    return { ok: false, message: 'Skill name is required' };\n  }\n  if (typeof body !== 'string' || body.length === 0) {\n    return { ok: false, message: 'Skill body is required' };\n  }\n  return { ok: true, value: { name, body } };\n}\n\nexport interface ProcessKillPayload {\n  pid: number;\n}\n\nexport function validateProcessKillPayload(\n  payload: unknown,\n): PayloadValidationResult<ProcessKillPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'process.kill payload must be an object with numeric pid' };\n  }\n  const pid = payload['pid'];\n  if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0) {\n    return { ok: false, message: 'process.kill payload.pid must be a positive integer' };\n  }\n  return { ok: true, value: { pid } };\n}\n\nexport interface WorkingDirSetPayload {\n  path: string;\n}\n\nexport function validateWorkingDirSetPayload(\n  payload: unknown,\n): PayloadValidationResult<WorkingDirSetPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'working_dir.set payload must be an object with string path' };\n  }\n  const newPath = payload['path'];\n  if (typeof newPath !== 'string' || newPath.trim().length === 0) {\n    return { ok: false, message: 'working_dir.set payload.path must be a non-empty string' };\n  }\n  return { ok: true, value: { path: newPath } };\n}\n\nexport interface ModeSwitchPayload {\n  id: string;\n}\n\nexport function validateModeSwitchPayload(\n  payload: unknown,\n): PayloadValidationResult<ModeSwitchPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'mode.switch payload must be an object with string id' };\n  }\n  const id = payload['id'];\n  if (typeof id !== 'string' || id.trim().length === 0) {\n    return { ok: false, message: 'mode.switch payload.id must be a non-empty string' };\n  }\n  return { ok: true, value: { id } };\n}\n\nexport interface ContextModeIdPayload {\n  id: string;\n}\n\nfunction validateContextModeIdPayload(\n  payload: unknown,\n  type: 'context.mode.switch' | 'context.mode.delete',\n): PayloadValidationResult<ContextModeIdPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: `${type} payload must be an object with string id` };\n  }\n  const id = payload['id'];\n  if (typeof id !== 'string' || id.trim().length === 0) {\n    return { ok: false, message: `${type} payload.id must be a non-empty string` };\n  }\n  return { ok: true, value: { id } };\n}\n\nexport function validateContextModeSwitchPayload(\n  payload: unknown,\n): PayloadValidationResult<ContextModeIdPayload> {\n  return validateContextModeIdPayload(payload, 'context.mode.switch');\n}\n\nexport function validateContextModeDeletePayload(\n  payload: unknown,\n): PayloadValidationResult<ContextModeIdPayload> {\n  return validateContextModeIdPayload(payload, 'context.mode.delete');\n}\n\nexport interface ContextModeCreatePayload {\n  id: string;\n  name: string;\n  description: string;\n  thresholds: { warn: number; soft: number; hard: number };\n  preserveK: number;\n  eliseThreshold: number;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\nexport function validateContextModeCreatePayload(\n  payload: unknown,\n): PayloadValidationResult<ContextModeCreatePayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'context.mode.create payload must be an object' };\n  }\n  const id = payload['id'];\n  const name = payload['name'];\n  const description = payload['description'];\n  const thresholds = payload['thresholds'];\n  const preserveK = payload['preserveK'];\n  const eliseThreshold = payload['eliseThreshold'];\n\n  if (typeof id !== 'string' || id.trim().length === 0) {\n    return { ok: false, message: 'context.mode.create payload.id must be a non-empty string' };\n  }\n  if (typeof name !== 'string' || name.trim().length === 0) {\n    return { ok: false, message: 'context.mode.create payload.name must be a non-empty string' };\n  }\n  if (typeof description !== 'string') {\n    return { ok: false, message: 'context.mode.create payload.description must be a string' };\n  }\n  if (!isRecord(thresholds)) {\n    return {\n      ok: false,\n      message:\n        'context.mode.create payload.thresholds must be an object with warn/soft/hard numbers',\n    };\n  }\n  if (\n    !isFiniteNumber(thresholds['warn']) ||\n    !isFiniteNumber(thresholds['soft']) ||\n    !isFiniteNumber(thresholds['hard'])\n  ) {\n    return {\n      ok: false,\n      message: 'context.mode.create payload.thresholds.warn/soft/hard must be finite numbers',\n    };\n  }\n  if (!isFiniteNumber(preserveK)) {\n    return { ok: false, message: 'context.mode.create payload.preserveK must be a finite number' };\n  }\n  if (!isFiniteNumber(eliseThreshold)) {\n    return {\n      ok: false,\n      message: 'context.mode.create payload.eliseThreshold must be a finite number',\n    };\n  }\n  return {\n    ok: true,\n    value: {\n      id,\n      name,\n      description,\n      thresholds: { warn: thresholds['warn'], soft: thresholds['soft'], hard: thresholds['hard'] },\n      preserveK,\n      eliseThreshold,\n    },\n  };\n}\n\nexport interface ContextModeUpdatePayload {\n  id: string;\n  name?: string;\n  description?: string;\n  thresholds?: { warn?: number; soft?: number; hard?: number };\n  preserveK?: number;\n  eliseThreshold?: number;\n}\n\nexport function validateContextModeUpdatePayload(\n  payload: unknown,\n): PayloadValidationResult<ContextModeUpdatePayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'context.mode.update payload must be an object' };\n  }\n  const id = payload['id'];\n  if (typeof id !== 'string' || id.trim().length === 0) {\n    return { ok: false, message: 'context.mode.update payload.id must be a non-empty string' };\n  }\n\n  const name = payload['name'];\n  if (name !== undefined && typeof name !== 'string') {\n    return {\n      ok: false,\n      message: 'context.mode.update payload.name must be a string when provided',\n    };\n  }\n\n  const description = payload['description'];\n  if (description !== undefined && typeof description !== 'string') {\n    return {\n      ok: false,\n      message: 'context.mode.update payload.description must be a string when provided',\n    };\n  }\n\n  const thresholds = payload['thresholds'];\n  let validatedThresholds: ContextModeUpdatePayload['thresholds'];\n  if (thresholds !== undefined) {\n    if (!isRecord(thresholds)) {\n      return {\n        ok: false,\n        message: 'context.mode.update payload.thresholds must be an object when provided',\n      };\n    }\n    for (const key of ['warn', 'soft', 'hard'] as const) {\n      const val = thresholds[key];\n      if (val !== undefined && !isFiniteNumber(val)) {\n        return {\n          ok: false,\n          message: `context.mode.update payload.thresholds.${key} must be a finite number when provided`,\n        };\n      }\n    }\n    validatedThresholds = {\n      ...(typeof thresholds['warn'] === 'number' ? { warn: thresholds['warn'] } : {}),\n      ...(typeof thresholds['soft'] === 'number' ? { soft: thresholds['soft'] } : {}),\n      ...(typeof thresholds['hard'] === 'number' ? { hard: thresholds['hard'] } : {}),\n    };\n  }\n\n  const preserveK = payload['preserveK'];\n  if (preserveK !== undefined && !isFiniteNumber(preserveK)) {\n    return {\n      ok: false,\n      message: 'context.mode.update payload.preserveK must be a finite number when provided',\n    };\n  }\n\n  const eliseThreshold = payload['eliseThreshold'];\n  if (eliseThreshold !== undefined && !isFiniteNumber(eliseThreshold)) {\n    return {\n      ok: false,\n      message: 'context.mode.update payload.eliseThreshold must be a finite number when provided',\n    };\n  }\n\n  return {\n    ok: true,\n    value: {\n      id,\n      ...(typeof name === 'string' ? { name } : {}),\n      ...(typeof description === 'string' ? { description } : {}),\n      ...(validatedThresholds !== undefined ? { thresholds: validatedThresholds } : {}),\n      ...(typeof preserveK === 'number' ? { preserveK } : {}),\n      ...(typeof eliseThreshold === 'number' ? { eliseThreshold } : {}),\n    },\n  };\n}\n\nexport interface ShellOpenPayload {\n  path: string;\n  target?: 'file' | 'terminal';\n}\n\nexport function validateShellOpenPayload(\n  payload: unknown,\n): PayloadValidationResult<ShellOpenPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'shell.open payload must be an object with string path' };\n  }\n  const path = payload['path'];\n  if (typeof path !== 'string' || path.trim().length === 0) {\n    return { ok: false, message: 'shell.open payload.path must be a non-empty string' };\n  }\n  const target = payload['target'];\n  if (target !== undefined && target !== 'file' && target !== 'terminal') {\n    return {\n      ok: false,\n      message: 'shell.open payload.target must be \"file\" or \"terminal\" when provided',\n    };\n  }\n  return {\n    ok: true,\n    value: {\n      path,\n      ...(target !== undefined ? { target: target as 'file' | 'terminal' } : {}),\n    },\n  };\n}\n\nexport interface GitDiffPayload {\n  path: string;\n}\n\nexport function validateGitDiffPayload(payload: unknown): PayloadValidationResult<GitDiffPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'git.diff payload must be an object' };\n  }\n  const path = payload['path'];\n  if (path === undefined || path === null) {\n    return { ok: true, value: { path: '' } };\n  }\n  if (typeof path !== 'string') {\n    return { ok: false, message: 'git.diff payload.path must be a string when provided' };\n  }\n  return { ok: true, value: { path } };\n}\n\nexport interface ProjectsAddPayload {\n  root: string;\n  name?: string;\n}\n\nexport function validateProjectsAddPayload(\n  payload: unknown,\n): PayloadValidationResult<ProjectsAddPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'projects.add payload must be an object with string root' };\n  }\n  const root = payload['root'];\n  if (typeof root !== 'string' || root.trim().length === 0) {\n    return { ok: false, message: 'projects.add payload.root must be a non-empty string' };\n  }\n  const name = payload['name'];\n  if (name !== undefined && typeof name !== 'string') {\n    return { ok: false, message: 'projects.add payload.name must be a string when provided' };\n  }\n  return {\n    ok: true,\n    value: { root, ...(typeof name === 'string' ? { name } : {}) },\n  };\n}\n\nexport interface ProjectsSelectPayload {\n  root: string;\n  name?: string;\n}\n\nexport function validateProjectsSelectPayload(\n  payload: unknown,\n): PayloadValidationResult<ProjectsSelectPayload> {\n  if (!isRecord(payload)) {\n    return { ok: false, message: 'projects.select payload must be an object with string root' };\n  }\n  const root = payload['root'];\n  if (typeof root !== 'string' || root.trim().length === 0) {\n    return { ok: false, message: 'projects.select payload.root must be a non-empty string' };\n  }\n  const name = payload['name'];\n  if (name !== undefined && typeof name !== 'string') {\n    return { ok: false, message: 'projects.select payload.name must be a string when provided' };\n  }\n  return {\n    ok: true,\n    value: { root, ...(typeof name === 'string' ? { name } : {}) },\n  };\n}\n","// ── Shared Worklist Handlers ─────────────────────────────────────────────────\n// Extracted from standalone server (packages/webui/src/server/index.ts) and CLI\n// embedded server (packages/cli/src/webui-server/). Both servers use these\n// handlers for todos, tasks, and plan operations. Keep them in sync.\n//\n// Message types handled here:\n//   todos.get | todos.clear | todos.remove | todo.update\n//   tasks.get | task.update\n//   plan.get | plan.template_use | plan.item.update\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { WebSocket } from 'ws';\nimport type { TodoItem } from '@wrongstack/core';\nimport { validatePlanTemplateUsePayload } from '../ws-payload-validation.js';\n\n// ── Shared result helper ───────────────────────────────────────────────────────\n\nfunction sendResult(\n  ws: WebSocket,\n  ctx: WorklistContext,\n  ok: boolean,\n  message: string,\n): void {\n  ctx.send(ws, { type: ok ? 'ok' : 'error', message });\n}\n\nfunction sessionPayload<T extends Record<string, unknown>>(\n  ctx: WorklistContext,\n  payload: T,\n): T & { sessionId: string } {\n  const provided = payload['sessionId'];\n  const fallback = ctx.context.session?.id ?? '';\n  const sessionId = typeof provided === 'string' && provided.length > 0 ? provided : fallback;\n  return { ...payload, sessionId };\n}\n\n// ── Context interface ─────────────────────────────────────────────────────────\n// Both servers satisfy this with their own local state.\n\nexport interface WorklistContext {\n  context: {\n    todos: TodoItem[];\n    meta: Record<string, unknown>;\n    session: { id: string } | null;\n    state?: unknown;\n  };\n  send: (ws: WebSocket, msg: object) => void;\n  broadcast: (msg: object) => void;\n  /**\n   * Optional mutator for in-memory todo state. Servers that manage live\n   * agent state (e.g. the CLI embedded server) provide this so handlers\n   * can update the agent's todo list directly. Standalone server may omit.\n   */\n  replaceTodos?: (todos: TodoItem[]) => void;\n}\n\n// ── Todos ─────────────────────────────────────────────────────────────────────\n\nexport function handleTodosGet(ctx: WorklistContext, ws: WebSocket): void {\n  ctx.send(ws, { type: 'todos.updated', payload: sessionPayload(ctx, { todos: ctx.context.todos }) });\n}\n\nexport function handleTodosClear(ctx: WorklistContext, ws: WebSocket): void {\n  ctx.replaceTodos?.([]);\n  ctx.broadcast({ type: 'todos.cleared', payload: sessionPayload(ctx, {}) });\n  sendResult(ws, ctx, true, 'Todo board cleared.');\n}\n\nexport function handleTodosRemove(\n  ctx: WorklistContext,\n  ws: WebSocket,\n  payload: { id?: string; index?: number } | undefined,\n): void {\n  if (!payload || (payload.id === undefined && payload.index === undefined)) {\n    sendResult(ws, ctx, false, 'todos.remove requires id or index.');\n    return;\n  }\n  const next =\n    payload.id !== undefined\n      ? ctx.context.todos.filter((t) => t.id !== payload.id)\n      : ctx.context.todos.filter((_, i) => i !== (payload.index as number));\n  ctx.replaceTodos?.(next);\n  ctx.broadcast({ type: 'todos.updated', payload: sessionPayload(ctx, { todos: next }) });\n  sendResult(ws, ctx, true, 'Todo item removed.');\n}\n\nexport function handleTodoUpdate(\n  ctx: WorklistContext,\n  ws: WebSocket,\n  payload: { id: string; status?: TodoItem['status']; activeForm?: string },\n): void {\n  const todo = ctx.context.todos.find((t) => t.id === payload.id);\n  if (!todo) {\n    sendResult(ws, ctx, false, `No todo with id \"${payload.id}\".`);\n    return;\n  }\n  const next = ctx.context.todos.map((t) =>\n    t.id === payload.id\n      ? { ...t, ...(payload.status !== undefined && { status: payload.status }), ...(payload.activeForm !== undefined && { activeForm: payload.activeForm }) }\n      : t,\n  );\n  ctx.replaceTodos?.(next);\n  ctx.broadcast({ type: 'todos.updated', payload: sessionPayload(ctx, { todos: next }) });\n  sendResult(ws, ctx, true, `Todo \"${todo.content}\" updated.`);\n}\n\n// ── Tasks ─────────────────────────────────────────────────────────────────────\n\nexport async function handleTasksGet(ctx: WorklistContext, ws: WebSocket): Promise<void> {\n  const taskPath = ctx.context.meta['task.path'];\n  if (typeof taskPath === 'string' && taskPath) {\n    try {\n      const { loadTasks } = await import('@wrongstack/core');\n      const file = await loadTasks(taskPath);\n      ctx.send(ws, { type: 'tasks.updated', payload: sessionPayload(ctx, { tasks: file?.tasks ?? [] }) });\n    } catch {\n      ctx.send(ws, { type: 'tasks.updated', payload: sessionPayload(ctx, { tasks: [] }) });\n    }\n  } else {\n    ctx.send(ws, {\n      type: 'tasks.updated',\n      payload: sessionPayload(ctx, { tasks: [], error: 'Task storage not configured.' }),\n    });\n  }\n}\n\nexport async function handleTaskUpdate(\n  ctx: WorklistContext,\n  ws: WebSocket,\n  payload: {\n    id: string;\n    status: 'pending' | 'in_progress' | 'blocked' | 'failed' | 'review' | 'completed';\n  },\n): Promise<void> {\n  const taskPath = ctx.context.meta['task.path'];\n  if (typeof taskPath !== 'string' || !taskPath) {\n    sendResult(ws, ctx, false, 'Task storage is not configured for this session.');\n    return;\n  }\n  try {\n    const { loadTasks, saveTasks } = await import('@wrongstack/core');\n    const file = await loadTasks(taskPath);\n    if (!file) {\n      sendResult(ws, ctx, false, 'No task file found.');\n      return;\n    }\n    const idx = file.tasks.findIndex((t) => t.id === payload.id);\n    if (idx === -1) {\n      sendResult(ws, ctx, false, `Task \"${payload.id}\" not found.`);\n      return;\n    }\n    const existing = file.tasks[idx];\n    if (!existing) {\n      // noUncheckedIndexedAccess: array access can be undefined. We just\n      // confirmed idx is in-range via findIndex, but the type system needs\n      // the explicit guard.\n      sendResult(ws, ctx, false, `Task \"${payload.id}\" not found.`);\n      return;\n    }\n    file.tasks[idx] = { ...existing, status: payload.status };\n    await saveTasks(taskPath, file);\n    ctx.broadcast({ type: 'tasks.updated', payload: sessionPayload(ctx, { tasks: file.tasks }) });\n    sendResult(ws, ctx, true, `Task \"${payload.id}\" marked ${payload.status}.`);\n  } catch (err) {\n    sendResult(ws, ctx, false, String(err));\n  }\n}\n\n// ── Plan ───────────────────────────────────────────────────────────────────────\n\nexport async function handlePlanGet(ctx: WorklistContext, ws: WebSocket): Promise<void> {\n  const planPath = ctx.context.meta['plan.path'];\n  const sessionId = ctx.context.session?.id ?? '';\n  if (typeof planPath === 'string' && planPath) {\n    try {\n      const { loadPlan } = await import('@wrongstack/core');\n      const plan = await loadPlan(planPath);\n      ctx.send(ws, {\n        type: 'plan.updated',\n        payload: sessionPayload(ctx, {\n          plan: plan ?? {\n            version: 1,\n            sessionId,\n            updatedAt: new Date().toISOString(),\n            items: [],\n          },\n        }),\n      });\n    } catch {\n      ctx.send(ws, {\n        type: 'plan.updated',\n        payload: sessionPayload(ctx, {\n          plan: {\n            version: 1,\n            sessionId,\n            updatedAt: new Date().toISOString(),\n            items: [],\n          },\n        }),\n      });\n    }\n  } else {\n    ctx.send(ws, {\n      type: 'plan.updated',\n      payload: sessionPayload(ctx, { plan: null, error: 'Plan storage is not configured for this session.' }),\n    });\n  }\n}\n\nexport async function handlePlanTemplateUse(ctx: WorklistContext, ws: WebSocket, template: string): Promise<void> {\n  const planPath = ctx.context.meta['plan.path'];\n  const sessionId = ctx.context.session?.id ?? '';\n  if (typeof planPath !== 'string' || !planPath) {\n    sendResult(ws, ctx, false, 'Plan storage is not configured for this session.');\n    return;\n  }\n  try {\n    const { getPlanTemplate, loadPlan, savePlan, emptyPlan, addPlanItem } = await import('@wrongstack/core');\n    const tpl = getPlanTemplate(template);\n    if (!tpl) {\n      sendResult(ws, ctx, false, `Unknown template \"${template}\".`);\n      return;\n    }\n    let plan = (await loadPlan(planPath)) ?? emptyPlan(sessionId);\n    for (const item of tpl.items) {\n      ({ plan } = addPlanItem(plan, item.title, item.details));\n    }\n    await savePlan(planPath, plan);\n    sendResult(ws, ctx, true, `Applied template \"${tpl.name}\" — ${tpl.items.length} items added.`);\n    ctx.broadcast({ type: 'plan.updated', payload: sessionPayload(ctx, { plan }) });\n  } catch (err) {\n    sendResult(ws, ctx, false, String(err));\n  }\n}\n\nexport async function handlePlanItemUpdate(\n  ctx: WorklistContext,\n  ws: WebSocket,\n  payload: { target: string; status: 'open' | 'in_progress' | 'done' },\n): Promise<void> {\n  const planPath = ctx.context.meta['plan.path'];\n  const sessionId = ctx.context.session?.id ?? '';\n  if (typeof planPath !== 'string' || !planPath) {\n    sendResult(ws, ctx, false, 'Plan storage is not configured for this session.');\n    return;\n  }\n  try {\n    const { mutatePlan, setPlanItemStatus } = await import('@wrongstack/core');\n    let changed = false;\n    const plan = await mutatePlan(planPath, sessionId, async (p) => {\n      const before = p.updatedAt;\n      const updated = setPlanItemStatus(p, payload.target, payload.status);\n      changed = updated.updatedAt !== before;\n      return updated;\n    });\n    if (!changed) {\n      sendResult(ws, ctx, false, `No plan item matched \"${payload.target}\".`);\n      return;\n    }\n    sendResult(ws, ctx, true, `Plan item status updated to \"${payload.status}\".`);\n    ctx.broadcast({ type: 'plan.updated', payload: sessionPayload(ctx, { plan }) });\n  } catch (err) {\n    sendResult(ws, ctx, false, String(err));\n  }\n}\n\n// ── Dispatcher ──────────────────────────────────────────────────────────────────\n// Single entry point for the nine worklist message types, so the host server's\n// switch delegates one grouped case here instead of repeating the per-type\n// `makeWorklistContext()` boilerplate. Unknown types are a no-op (the caller\n// only routes worklist types to this function).\n\n/** Loosely-typed worklist WS message — payload shapes are narrowed per case. */\nexport interface WorklistMessage {\n  type: string;\n  payload?: unknown;\n}\n\nexport async function handleWorklistMessage(\n  ctx: WorklistContext,\n  ws: WebSocket,\n  msg: WorklistMessage,\n): Promise<void> {\n  switch (msg.type) {\n    case 'todos.get':\n      handleTodosGet(ctx, ws);\n      return;\n    case 'todos.clear':\n      handleTodosClear(ctx, ws);\n      return;\n    case 'todos.remove':\n      handleTodosRemove(ctx, ws, msg.payload as { id?: string; index?: number } | undefined);\n      return;\n    case 'todo.update':\n      handleTodoUpdate(\n        ctx,\n        ws,\n        msg.payload as { id: string; status?: TodoItem['status']; activeForm?: string },\n      );\n      return;\n    case 'tasks.get':\n      await handleTasksGet(ctx, ws);\n      return;\n    case 'task.update':\n      await handleTaskUpdate(\n        ctx,\n        ws,\n        msg.payload as {\n          id: string;\n          status: 'pending' | 'in_progress' | 'blocked' | 'failed' | 'review' | 'completed';\n        },\n      );\n      return;\n    case 'plan.get':\n      await handlePlanGet(ctx, ws);\n      return;\n    case 'plan.template_use': {\n      const parsed = validatePlanTemplateUsePayload(msg.payload);\n      if (!parsed.ok) {\n        sendResult(ws, ctx, false, parsed.message);\n        return;\n      }\n      await handlePlanTemplateUse(ctx, ws, parsed.value.template);\n      return;\n    }\n    case 'plan.item.update':\n      await handlePlanItemUpdate(\n        ctx,\n        ws,\n        msg.payload as { target: string; status: 'open' | 'in_progress' | 'done' },\n      );\n      return;\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@wrongstack/webui-server",
+  "version": "0.284.0",
+  "license": "MIT",
+  "description": "WrongStack WebUI HTTP/WebSocket server module — extracted from @wrongstack/webui in PR #243/244 to remove the CLI -> @wrongstack/webui/server cross-package edge (audit §3.1.1). Pure backend: HTTP routes, WebSocket handlers, MCP tool wrappers, HTML serving. The web frontend lives in @wrongstack/webui; this package is the standalone server it can run on.",
+  "keywords": [
+    "wrongstack",
+    "webui",
+    "websocket",
+    "http"
+  ],
+  "homepage": "https://github.com/WrongStack/WrongStack#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WrongStack/WrongStack.git",
+    "directory": "packages/webui-server"
+  },
+  "bugs": {
+    "url": "https://github.com/WrongStack/WrongStack/issues"
+  },
+  "author": "ECOSTACK TECHNOLOGY OÜ",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "wstackui": "./dist/server/entry.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "jszip": "^3.10.1",
+    "ws": "^8.21.0",
+    "@wrongstack/core": "0.284.0",
+    "@wrongstack/kanban": "0.284.0",
+    "@wrongstack/runtime": "0.284.0",
+    "@wrongstack/mcp": "0.284.0",
+    "@wrongstack/providers": "0.284.0",
+    "@wrongstack/tools": "0.284.0",
+    "@wrongstack/sdd": "0.284.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}