@konglx/rotom 2.21.0

package/dist/shared/logger.js

@@ -0,0 +1,136 @@
+import { nowBeijing } from "./time.js";
+/**
+ * Digital Employee Mesh — Logger
+ *
+ * Lightweight structured logger with timestamps. No external dependencies.
+ * Supports optional daily-rotated file output with auto-cleanup.
+ *
+ * Usage:
+ *   const log = createLogger("mesh-master");
+ *   log.info("started");                         // → stdout only
+ *
+ *   enableFileLogging("~/.rotom/logs");        // enable file output
+ *   log.info("with file");                        // → stdout + logs/mesh-master-2026-03-23.log
+ *
+ * Stream selection:
+ *   - `createLogger("mesh-master")`             → default: info/log to stdout, warn/error to stderr
+ *   - `createLogger("mesh-executor", { stream: "stderr" })` → all levels to stderr
+ *     (use this in executor so log lines never pollute stdout, which keeps
+ *     stdout free for any machine-parsed output the master might consume)
+ *
+ * The file-name prefix is derived from the module name passed to
+ * createLogger — `createLogger("mesh-executor")` writes to
+ * `mesh-executor-YYYY-MM-DD.log` (not `mesh-master-...`).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { format } from "node:util";
+// ---------------------------------------------------------------------------
+// File logging state (shared across all loggers in this process)
+// ---------------------------------------------------------------------------
+let logDir = null;
+let currentDate = "";
+let currentFd = null;
+const LOG_RETAIN_DAYS = 30;
+function todayStr() {
+    return nowBeijing().slice(0, 10); // "2026-03-23"
+}
+function ensureFd() {
+    if (!logDir)
+        return null;
+    const today = todayStr();
+    if (today !== currentDate) {
+        // Day changed — rotate
+        if (currentFd !== null) {
+            try {
+                fs.closeSync(currentFd);
+            }
+            catch { /* ignore */ }
+        }
+        currentDate = today;
+        const filePath = path.join(logDir, `mesh-master-${today}.log`);
+        currentFd = fs.openSync(filePath, "a");
+    }
+    return currentFd;
+}
+function writeToFile(line) {
+    const fd = ensureFd();
+    if (fd !== null) {
+        try {
+            fs.writeSync(fd, line + "\n");
+        }
+        catch { /* non-fatal */ }
+    }
+}
+function cleanupOldLogs() {
+    if (!logDir)
+        return;
+    try {
+        const cutoff = Date.now() - LOG_RETAIN_DAYS * 86_400_000;
+        for (const name of fs.readdirSync(logDir)) {
+            if (!name.startsWith("mesh-") || !name.endsWith(".log"))
+                continue;
+            const filePath = path.join(logDir, name);
+            const stat = fs.statSync(filePath);
+            if (stat.mtimeMs < cutoff) {
+                fs.unlinkSync(filePath);
+            }
+        }
+    }
+    catch { /* non-fatal */ }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Enable daily-rotated file logging. All loggers created via createLogger()
+ * will also write to `{dir}/{module}-YYYY-MM-DD.log`.
+ * Old log files (>30 days) are cleaned up on enable.
+ */
+export function enableFileLogging(dir) {
+    const resolved = dir.startsWith("~")
+        ? dir.replace("~", process.env.HOME || "")
+        : dir;
+    fs.mkdirSync(resolved, { recursive: true });
+    logDir = resolved;
+    currentDate = ""; // force re-open
+    currentFd = null;
+    cleanupOldLogs();
+}
+/** Flush and close file logging (for graceful shutdown). */
+export function closeFileLogging() {
+    if (currentFd !== null) {
+        try {
+            fs.closeSync(currentFd);
+        }
+        catch { /* ignore */ }
+        currentFd = null;
+    }
+    logDir = null;
+}
+function ts() {
+    return nowBeijing();
+}
+/** Create a logger with a module prefix, e.g. createLogger("mesh-master") */
+export function createLogger(module, opts) {
+    const tag = `[${module}]`;
+    const stream = opts?.stream ?? "default";
+    function emit(level, consoleFn, args) {
+        const timestamp = ts();
+        const line = `${timestamp} ${level} ${tag} ${format(...args)}`;
+        consoleFn(timestamp, level, tag, ...args);
+        writeToFile(line);
+    }
+    // For "stderr" mode, every level writes to process.stderr; otherwise
+    // the default mapping is info/log → console.log (stdout), warn → console.warn
+    // (stderr), error → console.error (stderr).
+    const outFn = stream === "stderr" ? console.error : console.log;
+    const warnFn = stream === "stderr" ? console.error : console.warn;
+    const errFn = console.error;
+    return {
+        log: (...args) => emit("INFO", outFn, args),
+        info: (...args) => emit("INFO", outFn, args),
+        warn: (...args) => emit("WARN", warnFn, args),
+        error: (...args) => emit("ERROR", errFn, args),
+    };
+}

package/dist/shared/mention.js

@@ -0,0 +1,22 @@
+/**
+ * @-mention extraction.
+ *
+ * The pattern `/@([\w一-鿿][\w.一-鿿-]*)/g` matches a leading @ followed by an
+ * identifier that may contain ASCII word chars, CJK (一-鿿), dots, and hyphens.
+ * Extracted to `shared/mention.ts` so the 8+ call sites across master/ws-hub
+ * and master/api keep the same matching rules and slicing convention.
+ *
+ * `extractMentions` returns the names without the leading @. Returns an empty
+ * array for falsy / no-match input. No dedup — callers historically consumed
+ * the raw match list, so the helper preserves that.
+ */
+const MENTION_RE = /@([\w一-鿿][\w.一-鿿-]*)/g;
+export function extractMentions(content) {
+    if (!content)
+        return [];
+    const out = [];
+    for (const m of content.matchAll(MENTION_RE)) {
+        out.push(m[1]);
+    }
+    return out;
+}

package/dist/shared/network.js

@@ -0,0 +1,40 @@
+/**
+ * 判断 socket 远端地址是否本机(loopback)或局域网(可信内网)。
+ *
+ * 免 token 本机/局域网认证:本机进程或局域网内"我的设备"(iPad / Mac / 开发盒)
+ * 的请求/连接被信任,自动绑定本机 agent,跳过 mesh_token 校验。
+ *
+ * Node 在 IPv4-only 监听上会给出 `127.0.0.1`;
+ * 双栈监听上 IPv4 连接会给出 IPv4-mapped 形式 `::ffff:127.0.0.1`。
+ * 局域网段:192.168.0.0/16 / 10.0.0.0/8 / 172.16.0.0/12(含 IPv4-mapped 形式)。
+ */
+export function isLoopback(addr) {
+    if (!addr)
+        return false;
+    return (addr === "127.0.0.1" ||
+        addr === "::1" ||
+        addr === "::ffff:127.0.0.1");
+}
+/** 局域网 IP 段(可信内网,与 loopback 一起走免 token 信任) */
+export function isLocalNetwork(addr) {
+    if (!addr)
+        return false;
+    if (isLoopback(addr))
+        return true;
+    // 去掉 IPv4-mapped 前缀 `::ffff:` 便于匹配
+    const v4 = addr.replace(/^::ffff:/, "");
+    // 192.168.x.x
+    if (/^192\.168\.\d{1,3}\.\d{1,3}$/.test(v4))
+        return true;
+    // 10.x.x.x
+    if (/^10\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(v4))
+        return true;
+    // 172.16-31.x.x
+    const m172 = /^172\.(\d{1,3})\.\d{1,3}\.\d{1,3}$/.exec(v4);
+    if (m172) {
+        const second = parseInt(m172[1], 10);
+        if (second >= 16 && second <= 31)
+            return true;
+    }
+    return false;
+}

package/dist/shared/parse.js

@@ -0,0 +1,18 @@
+/**
+ * Parse helpers for untrusted JSON strings.
+ *
+ * Use `safeJsonParse(s, fallback)` whenever the caller's contract is
+ * "parse if valid, otherwise use a default" — replaces the
+ *   try { x = JSON.parse(s || "{}"); } catch { /* fall back *\/ }
+ * boilerplate that appears across the codebase.
+ */
+export function safeJsonParse(s, fallback) {
+    if (s == null || s === "")
+        return fallback;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return fallback;
+    }
+}

package/dist/shared/prompt-composer.js

@@ -0,0 +1,171 @@
+import { nowBeijing } from "./time.js";
+/**
+ * Prompt 组合器 —— 把"喂给 CLI agent 的 prompt"分层组装,每层标数据源。
+ *
+ * 拼接顺序:rotom-cli → agent-role → group-basic → cwd → task
+ *  - rotom-cli: rotom CLI 使用规则(`ROTOM_CLI_PROMPT`),所有 agent 一致
+ *  - agent-role: 来自 `agents.profile` JSON,per-agent
+ *  - group-basic: 群上下文 + 活跃 issue 列表,群内所有 agent 一致
+ *  - cwd: 工作目录只读头(如有 cwd)
+ *  - task: chat 模式 = 用户原消息;issue 模式 = title + description
+ *
+ * 设计:这是**纯函数**,无 IO。worker 调它,拿到 ComposedPrompt 后:
+ *  1. `prompt = composed.final` 喂给 executor
+ *  2. `composed.layers` 经由 `a2a_reply_end` / `issue_update` 透传给 master 入库
+ *  3. 前端点击消息 → 直接读库渲染,无需重算
+ */
+import { ROTOM_CLI_PROMPT, ROTOM_CLI_PROMPT_VERSION } from "./rotom-cli-prompt.js";
+// ── Layer builders ──────────────────────────────────────────────────────
+const SOURCE_ROTOM_CLI = "src/shared/rotom-cli-prompt.ts (constant)";
+const SOURCE_AGENT_PROFILE = "agents.profile JSON (edit via Dashboard 员工介绍)";
+const SOURCE_GROUP_BASIC = "groups + active_issues (runtime, from master enrichGroupConversation)";
+const SOURCE_GROUP_GUIDANCE = "groups.guidance_prompt (edit via Dashboard 群设置 / PATCH /groups/:id)";
+const SOURCE_CWD = "<worker.executor>.resolveIssueCwd(groupId)";
+function buildRotomCliLayer() {
+    return { layer: "rotom-cli", content: ROTOM_CLI_PROMPT, source: SOURCE_ROTOM_CLI };
+}
+function buildAgentRoleLayer(profile) {
+    if (!profile)
+        return null;
+    const fields = [
+        ["category", profile.category],
+        ["position", profile.position],
+        ["bio", profile.bio],
+    ];
+    const present = fields.filter(([, v]) => typeof v === "string" && v.length > 0);
+    if (present.length === 0)
+        return null;
+    const lines = ["[Agent 角色]", ...present.map(([k, v]) => `${k}: ${v}`)];
+    return { layer: "agent-role", content: lines.join("\n") + "\n", source: SOURCE_AGENT_PROFILE };
+}
+function buildGroupBasicLayer(group, selfName) {
+    if (!group)
+        return null;
+    const header = `[群消息 context: groupId=${group.id}, groupName="${group.name}", 你自己是="${selfName}"]\n`;
+    const issuesBlock = renderActiveIssues(group.activeIssues);
+    return {
+        layer: "group-basic",
+        content: header + issuesBlock,
+        source: SOURCE_GROUP_BASIC,
+    };
+}
+/** 群级别指导 prompt;空/null 不渲染。在 group-basic 之后、cwd 之前插入。 */
+function buildGroupGuidanceLayer(group) {
+    if (!group)
+        return null;
+    const prompt = group.guidancePrompt;
+    if (!prompt || !prompt.trim())
+        return null;
+    return {
+        layer: "group-guidance",
+        content: `[群指导] ${prompt.trim()}\n`,
+        source: SOURCE_GROUP_GUIDANCE,
+    };
+}
+function renderActiveIssues(issues) {
+    const n = issues?.length ?? 0;
+    const status = n === 0 ? "无" : `${n} 个进行中`;
+    return `[当前群活跃 issue] ${status}\n`;
+}
+function buildCwdLayer(cwd, mode, approvalPolicy) {
+    if (!cwd)
+        return null;
+    // 写盘策略单行(详细话术见 SKILL.md 锚点):
+    //   chat    → 只读,仅 Read/Grep/Glob/Bash(只读)
+    //   rw_allow → 可写,Write/Edit/写 Bash 自动放行,无需 dashboard
+    //   r_allow  → 可写,但写盘需 dashboard Accept/Deny;要免审批用 --approval-policy rw_allow
+    const effectivePolicy = approvalPolicy ?? "rw_allow";
+    const writability = mode === "chat"
+        ? `模式: chat(只读)。仅可 Read/Grep/Glob/Bash(只读);要写盘见 SKILL.md#写盘兜底话术。\n`
+        : effectivePolicy === "rw_allow"
+            ? `模式: ${mode},可写(rw_allow)。Write/Edit/写 Bash 自动放行,无需 dashboard 确认;只写本任务相关产出。\n`
+            : `模式: ${mode},可写(r_allow)。写盘类(Write/Edit/写 Bash)会被挂起等 dashboard Accept/Deny;只读 Bash(ls/cat/grep/git status/git diff/git log/rotom status 等)自动放行不打扰;要完全免审批用 --approval-policy rw_allow。\n`;
+    return {
+        layer: "cwd",
+        content: `[artifacts目录] ${cwd}\n` +
+            `相对路径基于此目录解析;Read/Grep/Glob 用相对路径即可,不要 \`cd\` 切到其他目录。\n` +
+            writability,
+        source: SOURCE_CWD,
+    };
+}
+function buildTaskLayer(body, mode, fromName) {
+    let source;
+    let content;
+    switch (mode) {
+        case "chat":
+            source = "user message (GroupChatView.handleSendMessage → ws a2a_send.payload.message)";
+            content = fromName ? `[from=${fromName}]\n${body}` : body;
+            break;
+        case "issue":
+            source = "issues.title + issues.description (db.ts:executeIssue)";
+            content = body;
+            break;
+    }
+    return { layer: "task", content, source };
+}
+/** 记忆极简指针层:只一行,告诉 agent 有多少记忆可查 + 怎么查。不展开索引,不干扰核心任务。 */
+function buildMemoryPointerLayer(counts) {
+    const total = counts.group + counts.global;
+    if (total === 0)
+        return null;
+    return {
+        layer: "memory-pointer",
+        content: `[可用记忆] 群 ${counts.group} 条 / 全局 ${counts.global} 条。` +
+            `需要时用 \`rotom memory search <关键词>\` 查询(支持 key/value/summary/tags),` +
+            `\`rotom memory get <id>\` 看详情;无关记忆忽略,不要硬套。\n`,
+        source: "agent_memory count (runtime, agent_visible=1, active, non-pending)",
+    };
+}
+/** skill 极简指针层:只一行,告诉 agent 有多少可用 skill + 怎么查。count=0 不注入。 */
+function buildSkillPointerLayer(count, groupId) {
+    if (count === 0)
+        return null;
+    const gidHint = groupId ? ` ${groupId}` : "";
+    return {
+        layer: "skill-pointer",
+        content: `[可用技能] ${count} 个。用 \`rotom skill mine${gidHint}\` 查列表,` +
+            `\`rotom skill get <name>\` 看详情;无关技能忽略,不要硬套。\n`,
+        source: "agent_skill_bindings count (runtime, group+agent scoped)",
+    };
+}
+// ── Public API ──────────────────────────────────────────────────────────
+export function composePrompt(ctx) {
+    const layers = [];
+    // Issue 模式的 prompt 不含 rotom CLI 使用规则:agent 直接执行任务描述,
+    // 不需要 rotom CLI 语法心智负担。该规则对群聊(chat)仍保留。
+    if (ctx.mode !== "issue") {
+        layers.push(buildRotomCliLayer());
+    }
+    const role = buildAgentRoleLayer(ctx.agentProfile);
+    if (role)
+        layers.push(role);
+    const group = buildGroupBasicLayer(ctx.group, ctx.agentName);
+    if (group)
+        layers.push(group);
+    const guidance = buildGroupGuidanceLayer(ctx.group);
+    if (guidance)
+        layers.push(guidance);
+    const cwd = buildCwdLayer(ctx.cwd, ctx.mode, ctx.approvalPolicy);
+    if (cwd)
+        layers.push(cwd);
+    // chat 模式下,发信人 fromName 注入到 task 层头部(只有 chat 才有 fromName 语义)。
+    layers.push(buildTaskLayer(ctx.body, ctx.mode, ctx.mode === "chat" ? ctx.fromName : null));
+    // 记忆极简指针层(末尾,优先级低,不干扰核心任务)
+    if (ctx.group?.memoryCounts) {
+        const ptr = buildMemoryPointerLayer(ctx.group.memoryCounts);
+        if (ptr)
+            layers.push(ptr);
+    }
+    // skill 极简指针层(最末尾,优先级最低)
+    if (ctx.group?.skillCount !== undefined) {
+        const ptr = buildSkillPointerLayer(ctx.group.skillCount, ctx.group?.id);
+        if (ptr)
+            layers.push(ptr);
+    }
+    return {
+        layers,
+        final: layers.map((l) => l.content).join("\n"),
+        generatedAt: nowBeijing(),
+        promptVersion: ROTOM_CLI_PROMPT_VERSION,
+    };
+}

package/dist/shared/protocol/client-messages.js

@@ -0,0 +1,8 @@
+/**
+ * Client → Master message definitions.
+ *
+ * Includes the `ClientMessage` union plus every concrete ClientXxxMessage
+ * shape. Consumers can import just this module to type incoming WS frames
+ * without pulling in server-side definitions.
+ */
+export {};

package/dist/shared/protocol/enums.js

@@ -0,0 +1,6 @@
+/**
+ * Real-person enum: human team members who can own issues / approve.
+ * Split from the protocol god-file so consumers needing only the enum don't
+ * pull in the full message union.
+ */
+export const REAL_PERSONS = ["孔令飞"];

package/dist/shared/protocol/federation.js

@@ -0,0 +1,62 @@
+/**
+ * Federation 协议 —— master 与 master 之间的通信。
+ *
+ * 拓扑(Phase 2):星型,所有跨 master 消息经协调 master 中转。
+ *   member ←→ coordination ←→ member
+ *
+ * 传输:WebSocket(ws://coord-host:port/federation),文本帧 JSON,最大 1MB。
+ * 认证:MVP 免认证,假设内网可信;但握手强制声明 masterId/hostname,
+ * 协调侧持久化来源便于审计 audit_log。
+ *
+ * 路由键:masterId(8 字符 base36,持久化在 ~/.rotom/master.json,永远稳定)。
+ * 显示键:hostname(可改,仅作展示,形如 alice@hostA)。
+ *
+ * 消息类型(8 个):
+ *   ─ 握手 ─
+ *     FedHandshake        member → coord,声明身份
+ *     FedHandshakeAck     coord → member,确认接入 / 报错(HOSTNAME_CONFLICT 等)
+ *   ─ 可见性发布 ─
+ *     FedAgentPublish     member → coord,增量发布本地 agent 状态
+ *     FedAgentUnpublish   member → coord,撤销发布(离开部门时)
+ *     FedDirectorySync    coord → member,全量/增量同步 agent_visibility
+ *   ─ 消息路由 ─
+ *     FedRouteMessage     member → coord,请求跨机投递
+ *     FedRouteDeliver     coord → member(目标侧),投递消息
+ *     FedRouteReply       member → coord → 来源 member,回复消息
+ */
+/** masterId 校验:8 字符 base36 小写 */
+export const MASTER_ID_PATTERN = /^[0-9a-z]{8}$/;
+/** hostname 校验:非空、非 IP(详见 src/master/federation/identity.ts isValidHostname) */
+export const HOSTNAME_PATTERN = /^[^\s:]+$/;
+/** 协议版本 — bump when fed wire format changes */
+export const FED_PROTOCOL_VERSION = 1;
+const FED_MESSAGE_TYPES = new Set([
+    "fed_handshake",
+    "fed_handshake_ack",
+    "fed_agent_publish",
+    "fed_agent_unpublish",
+    "fed_directory_sync",
+    "fed_route",
+    "fed_deliver",
+    "fed_reply",
+    "fed_route_failed",
+]);
+export function isFedMessage(x) {
+    if (!x || typeof x !== "object")
+        return false;
+    const msg = x;
+    if (typeof msg.type !== "string")
+        return false;
+    return FED_MESSAGE_TYPES.has(msg.type);
+}
+/** 解析 "alice@hostA" 形式;无 @ 则只返回 name */
+export function parseAgentRef(ref) {
+    const at = ref.lastIndexOf("@");
+    if (at <= 0)
+        return { name: ref };
+    return { name: ref.slice(0, at), hostname: ref.slice(at + 1) };
+}
+/** 组装 "alice@hostA" 形式 */
+export function formatAgentRef(name, hostname) {
+    return `${name}@${hostname}`;
+}

package/dist/shared/protocol/guards.js

@@ -0,0 +1,87 @@
+/**
+ * Runtime type guards for the mesh protocol.
+ *
+ * `isClientMessage` validates external WS input at the auth boundary (master
+ * connection handler). `isServerMessage` is provided for symmetry — workers
+ * that want to validate incoming master frames can use it.
+ */
+export function isClientMessage(x) {
+    if (!x || typeof x !== "object")
+        return false;
+    const msg = x;
+    if (typeof msg.type !== "string")
+        return false;
+    switch (msg.type) {
+        case "auth":
+            // token 在 OPC 本机模式下可空(master 端 isLoopback 信任直通);
+            // 跨机连接远程 master 时由 authenticate() 校验。
+            return typeof msg.name === "string"
+                && (msg.token === undefined || msg.token === null || typeof msg.token === "string");
+        case "heartbeat":
+            return true;
+        case "a2a_send":
+            return typeof msg.requestId === "string" && !!msg.payload;
+        case "a2a_reply":
+            return typeof msg.requestId === "string" && !!msg.payload;
+        case "a2a_reply_chunk":
+            return typeof msg.requestId === "string" && typeof msg.delta === "string";
+        case "a2a_reply_end":
+            return typeof msg.requestId === "string" && !!msg.payload;
+        case "update_info":
+            return true;
+        case "disconnect":
+            return true;
+        case "issue_update":
+            return typeof msg.issueId === "string" && typeof msg.status === "string";
+        case "issue_todos_update":
+            return typeof msg.issueId === "string" && Array.isArray(msg.todos);
+        case "issue_usage_progress":
+            return typeof msg.issueId === "string" && !!msg.usage;
+        case "subscribe_issue_detail":
+            return typeof msg.issueId === "string";
+        case "unsubscribe_issue_detail":
+            return typeof msg.issueId === "string";
+        case "issue_approval_request":
+            return typeof msg.issueId === "string"
+                && typeof msg.approvalId === "string"
+                && (msg.kind === "exec" || msg.kind === "file_change" || msg.kind === "plan" || msg.kind === "ask")
+                && typeof msg.summary === "string";
+        case "session_view_response":
+            return typeof msg.requestId === "string"
+                && typeof msg.groupId === "string"
+                && typeof msg.sessionId === "string"
+                && (msg.format === "jsonl" || msg.format === "text" || msg.format === "raw")
+                && typeof msg.content === "string";
+        case "session_delete_response":
+            return typeof msg.requestId === "string"
+                && typeof msg.groupId === "string"
+                && typeof msg.sessionId === "string"
+                && typeof msg.ok === "boolean";
+        case "session_snapshot":
+            return Array.isArray(msg.entries);
+        case "session_invalidated":
+            return typeof msg.cliTool === "string"
+                && typeof msg.groupId === "string"
+                && typeof msg.sessionId === "string";
+        default:
+            return false;
+    }
+}
+const SERVER_MESSAGE_TYPES = new Set([
+    "auth_ok", "auth_fail", "heartbeat_ack",
+    "a2a_message", "route_result", "directory_update", "offline_messages",
+    "update_info_ack", "config_update", "a2a_stream_chunk", "a2a_stream_end",
+    "issue_created", "issue_assigned", "issue_update_ack",
+    "issue_approval_response", "issue_cancelled", "chat_cancelled",
+    "issue_changed", "issue_continue", "issue_append", "issue_interrupt",
+    "issue_usage_progress",
+    "session_view_request", "session_delete_request", "session_sync_push",
+]);
+export function isServerMessage(x) {
+    if (!x || typeof x !== "object")
+        return false;
+    const msg = x;
+    if (typeof msg.type !== "string")
+        return false;
+    return SERVER_MESSAGE_TYPES.has(msg.type);
+}

package/dist/shared/protocol/server-messages.js

@@ -0,0 +1,8 @@
+/**
+ * Master → Client message definitions.
+ *
+ * Includes the `ServerMessage` union plus every concrete ServerXxxMessage
+ * shape. Consumers can import just this module to type outgoing WS frames
+ * without pulling in client-side definitions.
+ */
+export {};

package/dist/shared/protocol/types.js

@@ -0,0 +1,8 @@
+/**
+ * Base value interfaces used across the mesh protocol — agent info, file
+ * references, conversation context, message payload, todos, token usage,
+ * session entries. Pulled out of the protocol god-file so master DB rows,
+ * dashboard types, and executor code can share these without dragging in
+ * the full ClientMessage/ServerMessage unions.
+ */
+export {};

package/dist/shared/protocol.js

@@ -0,0 +1,19 @@
+/**
+ * Digital Employee Mesh — Protocol definitions
+ *
+ * All WebSocket message types between Agent and Master.
+ *
+ * This file is a barrel re-exporting from `./protocol/` submodules so
+ * existing `import { ... } from "../shared/protocol.js"` call sites keep
+ * working. New code may import from the specific sub-path:
+ *   - "../shared/protocol/enums.js"           — REAL_PERSONS, RealPerson
+ *   - "../shared/protocol/types.js"           — base value interfaces
+ *   - "../shared/protocol/client-messages.js" — ClientMessage union + shapes
+ *   - "../shared/protocol/server-messages.js" — ServerMessage union + shapes
+ *   - "../shared/protocol/guards.js"          — isClientMessage / isServerMessage
+ */
+export * from "./protocol/enums.js";
+export * from "./protocol/types.js";
+export * from "./protocol/client-messages.js";
+export * from "./protocol/server-messages.js";
+export { isClientMessage, isServerMessage } from "./protocol/guards.js";