@xrkseek/harness 0.5.9 → 0.5.11

package/node_modules/@xrkseek/server-face/dist/session-thread-store.js

@@ -0,0 +1,207 @@
+/**
+ * Workspace-scoped conversation 主线 catalog. Sessions attach to one thread
+ * and keep a short 支线 (current work). Survives session create/delete.
+ */
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { resolveXrkHome } from "@xrkseek/server-config";
+import { tryWriteJsonSidecar } from "./json-sidecar.js";
+export const THREAD_TITLE_MAX = 80;
+export const THREAD_BRIEF_MAX = 4_000;
+export const SIDELINE_MAX = 200;
+const ID_RE = /^th_[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/;
+export function threadsRoot(productHome) {
+    return path.join(path.resolve(productHome ?? resolveXrkHome()), "session-threads");
+}
+function sanitizeWorkspaceId(workspaceId) {
+    const trimmed = workspaceId.trim();
+    if (!trimmed || trimmed.includes("..") || trimmed.includes("/") || trimmed.includes("\\")) {
+        throw new Error(`invalid workspaceId: ${workspaceId}`);
+    }
+    return trimmed;
+}
+function filePath(workspaceId, productHome) {
+    return path.join(threadsRoot(productHome), `${sanitizeWorkspaceId(workspaceId)}.json`);
+}
+function mintId() {
+    return `th_${randomUUID().replaceAll("-", "").slice(0, 16)}`;
+}
+function clip(value, max) {
+    return value.replace(/\s+/g, " ").trim().slice(0, max);
+}
+function parseBind(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    const o = raw;
+    if (typeof o.threadId !== "string" || !ID_RE.test(o.threadId))
+        return undefined;
+    const sideline = typeof o.sideline === "string" ? clip(o.sideline, SIDELINE_MAX) : "";
+    return sideline
+        ? { threadId: o.threadId, sideline }
+        : { threadId: o.threadId };
+}
+function parseThread(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    const o = raw;
+    if (typeof o.id !== "string" || !ID_RE.test(o.id))
+        return undefined;
+    if (typeof o.title !== "string")
+        return undefined;
+    const title = clip(o.title, THREAD_TITLE_MAX);
+    if (!title)
+        return undefined;
+    const brief = typeof o.brief === "string" ? clip(o.brief, THREAD_BRIEF_MAX) : "";
+    const updatedAt = typeof o.updatedAt === "number" && Number.isFinite(o.updatedAt)
+        ? o.updatedAt
+        : 0;
+    return { id: o.id, title, brief, updatedAt };
+}
+function emptyDoc() {
+    return { version: 1, threads: [], sessions: {} };
+}
+export class FaceSessionThreadStore {
+    productHome;
+    cache = new Map();
+    constructor(productHome) {
+        this.productHome = productHome;
+    }
+    load(workspaceId) {
+        const cached = this.cache.get(workspaceId);
+        if (cached)
+            return cached;
+        const file = filePath(workspaceId, this.productHome);
+        if (!existsSync(file)) {
+            const doc = emptyDoc();
+            this.cache.set(workspaceId, doc);
+            return doc;
+        }
+        try {
+            const parsed = JSON.parse(readFileSync(file, "utf8"));
+            const o = parsed && typeof parsed === "object" ? parsed : emptyDoc();
+            const threads = Array.isArray(o.threads)
+                ? o.threads.flatMap((row) => {
+                    const thread = parseThread(row);
+                    return thread ? [thread] : [];
+                })
+                : [];
+            const sessions = {};
+            if (o.sessions && typeof o.sessions === "object") {
+                for (const [sessionId, bind] of Object.entries(o.sessions)) {
+                    const next = parseBind(bind);
+                    if (next)
+                        sessions[sessionId] = next;
+                }
+            }
+            const doc = { version: 1, threads, sessions };
+            this.cache.set(workspaceId, doc);
+            return doc;
+        }
+        catch {
+            const doc = emptyDoc();
+            this.cache.set(workspaceId, doc);
+            return doc;
+        }
+    }
+    save(workspaceId, doc) {
+        this.cache.set(workspaceId, doc);
+        const dir = threadsRoot(this.productHome);
+        mkdirSync(dir, { recursive: true });
+        tryWriteJsonSidecar(filePath(workspaceId, this.productHome), doc);
+    }
+    list(workspaceId) {
+        return this.load(workspaceId).threads;
+    }
+    get(workspaceId, threadId) {
+        return this.load(workspaceId).threads.find((row) => row.id === threadId);
+    }
+    bindOf(workspaceId, sessionId) {
+        return this.load(workspaceId).sessions[sessionId];
+    }
+    /** Every session currently attached to a 主线 in this workspace. */
+    listBinds(workspaceId) {
+        return Object.entries(this.load(workspaceId).sessions).map(([sessionId, bind]) => ({
+            sessionId,
+            ...bind,
+        }));
+    }
+    upsert(workspaceId, input) {
+        const title = clip(input.title, THREAD_TITLE_MAX);
+        if (!title)
+            return undefined;
+        const brief = clip(input.brief ?? "", THREAD_BRIEF_MAX);
+        const doc = this.load(workspaceId);
+        const id = input.id?.trim();
+        const now = Date.now();
+        if (id) {
+            if (!ID_RE.test(id))
+                return undefined;
+            const index = doc.threads.findIndex((row) => row.id === id);
+            const next = {
+                id,
+                title,
+                brief,
+                updatedAt: now,
+            };
+            const threads = index === -1
+                ? [...doc.threads, next]
+                : doc.threads.map((row, i) => (i === index ? next : row));
+            this.save(workspaceId, { ...doc, threads });
+            return next;
+        }
+        const minted = {
+            id: mintId(),
+            title,
+            brief,
+            updatedAt: now,
+        };
+        this.save(workspaceId, { ...doc, threads: [...doc.threads, minted] });
+        return minted;
+    }
+    switchTo(workspaceId, sessionId, threadId) {
+        const doc = this.load(workspaceId);
+        if (!doc.threads.some((row) => row.id === threadId))
+            return undefined;
+        const prev = doc.sessions[sessionId];
+        const next = {
+            threadId,
+            ...(prev?.sideline ? { sideline: prev.sideline } : {}),
+        };
+        this.save(workspaceId, {
+            ...doc,
+            sessions: { ...doc.sessions, [sessionId]: next },
+        });
+        return next;
+    }
+    /** Drop a 主线 and every session bind pointing at it. */
+    remove(workspaceId, threadId) {
+        const doc = this.load(workspaceId);
+        if (!doc.threads.some((row) => row.id === threadId))
+            return false;
+        const threads = doc.threads.filter((row) => row.id !== threadId);
+        const sessions = {};
+        for (const [sessionId, bind] of Object.entries(doc.sessions)) {
+            if (bind.threadId !== threadId)
+                sessions[sessionId] = bind;
+        }
+        this.save(workspaceId, { ...doc, threads, sessions });
+        return true;
+    }
+    setSideline(workspaceId, sessionId, sideline) {
+        const doc = this.load(workspaceId);
+        const prev = doc.sessions[sessionId];
+        if (!prev)
+            return undefined;
+        const clipped = clip(sideline, SIDELINE_MAX);
+        const next = clipped
+            ? { threadId: prev.threadId, sideline: clipped }
+            : { threadId: prev.threadId };
+        this.save(workspaceId, {
+            ...doc,
+            sessions: { ...doc.sessions, [sessionId]: next },
+        });
+        return next;
+    }
+}
+//# sourceMappingURL=session-thread-store.js.map

package/node_modules/@xrkseek/server-face/dist/session-thread-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-thread-store.js","sourceRoot":"","sources":["../src/session-thread-store.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/session-thread-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Model-facing thread_* / sideline_set — workspace 主线 catalog + session 支线.
+ */
+import type { ToolRegistry } from "@xrkseek/core-tools";
+import type { FaceRuntime } from "./context.js";
+export interface BindSessionThreadToolsOptions {
+    readonly runtime: FaceRuntime;
+    readonly sessionId: string;
+}
+/** Register thread_list / thread_upsert / thread_switch / thread_delete / sideline_set. */
+export declare function bindSessionThreadTools(tools: ToolRegistry, options: BindSessionThreadToolsOptions): void;
+//# sourceMappingURL=session-thread-tools.d.ts.map

package/node_modules/@xrkseek/server-face/dist/session-thread-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-thread-tools.d.ts","sourceRoot":"","sources":["../src/session-thread-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA8DD,2FAA2F;AAC3F,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAyLN"}

package/node_modules/@xrkseek/server-face/dist/session-thread-tools.js

@@ -0,0 +1,223 @@
+import { canvasWorkspaceIdForSession } from "./canvas-tools.js";
+import { publishSessionThread, publishSessionThreads, sessionIdsOnThread, } from "./session-thread-publish.js";
+import { SIDELINE_MAX } from "./session-thread-store.js";
+function registerTool(tools, tool) {
+    if (tools.get(tool.name))
+        return;
+    tools.register(tool);
+}
+function readArgs(args) {
+    if (!args || typeof args !== "object" || Array.isArray(args))
+        return {};
+    return args;
+}
+function sidelineOf(runtime, workspaceId, targetId) {
+    const bind = runtime.sessionThreads.bindOf(workspaceId, targetId);
+    const text = bind?.sideline ?? runtime.presence.get(targetId)?.tips;
+    return text ? text : undefined;
+}
+/**
+ * Catalog rows for this workspace only: 主线 entries plus parent sessions
+ * already attached. Unbound sessions (first-message sidebar titles) stay out.
+ */
+function listCatalog(runtime, workspaceId, selfId) {
+    const binds = runtime.sessionThreads.listBinds(workspaceId);
+    return runtime.sessionThreads.list(workspaceId).map((thread) => ({
+        id: thread.id,
+        title: thread.title,
+        brief: thread.brief,
+        updatedAt: thread.updatedAt,
+        sessions: binds.flatMap((row) => {
+            if (row.threadId !== thread.id)
+                return [];
+            if (runtime.subagents.getByChild(row.sessionId))
+                return [];
+            const sideline = sidelineOf(runtime, workspaceId, row.sessionId);
+            return [
+                {
+                    sessionId: row.sessionId,
+                    self: row.sessionId === selfId,
+                    ...(sideline ? { sideline } : {}),
+                },
+            ];
+        }),
+    }));
+}
+/** Register thread_list / thread_upsert / thread_switch / thread_delete / sideline_set. */
+export function bindSessionThreadTools(tools, options) {
+    const { runtime, sessionId } = options;
+    const ws = () => canvasWorkspaceIdForSession(runtime, sessionId);
+    registerTool(tools, {
+        name: "thread_list",
+        description: "List this workspace's 主线 catalog only (not other workspaces). " +
+            "A 主线 is an AI-owned collaboration pin: what this parent session is for, so sibling " +
+            "parent sessions in the same workspace can notice it, join it, or read it. " +
+            "It is not the user's message text. Do not mint from a greeting, a one-shot question, or a steer. " +
+            "When this session becomes a lasting mission, call thread_upsert yourself — do not wait to be asked. " +
+            "Each row lists parent sessions already attached. Unbound sessions do not appear. " +
+            "Sessions do not have a live chat bus; discover via this list, then session_search / session_read. " +
+            "Host may inject with session.prompt. Use thread_upsert / thread_delete yourself — never copy the user verbatim.",
+        parameters: { type: "object", properties: {}, additionalProperties: false },
+        isConcurrencySafe: () => true,
+        presentCall: () => ({
+            card: "generic",
+            title: "thread_list",
+            kind: "search",
+            rawInput: {},
+        }),
+        execute: async () => {
+            const workspaceId = ws();
+            return {
+                content: JSON.stringify({
+                    workspaceId,
+                    threads: listCatalog(runtime, workspaceId, sessionId),
+                    bind: runtime.sessionThreads.bindOf(workspaceId, sessionId) ?? null,
+                }),
+            };
+        },
+    });
+    registerTool(tools, {
+        name: "thread_upsert",
+        description: "Create or revise a workspace 主线 (title + optional brief) that you choose as the collaboration pin. " +
+            "When the work is a lasting mission, call this without waiting for the user to ask. " +
+            "Do not paste or paraphrase the user's latest message as the title. " +
+            "Skip greetings, one-shot Q&A, and mid-turn steers. " +
+            "Write a durable mission label siblings can anchor on. Pass id to revise. Default switch=true attaches this session.",
+        parameters: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                title: { type: "string", description: "Short AI-owned 主线 label (sidebar when bound)." },
+                brief: { type: "string", description: "What siblings should know this 主线 is for." },
+                switch: {
+                    type: "boolean",
+                    description: "If true (default), attach this session to the 主线.",
+                },
+            },
+            required: ["title"],
+            additionalProperties: false,
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "thread_upsert",
+            kind: "execute",
+            rawInput: args,
+        }),
+        execute: async (args) => {
+            const a = readArgs(args);
+            const title = String(a.title ?? "");
+            const brief = typeof a.brief === "string" ? a.brief : "";
+            const id = typeof a.id === "string" ? a.id : undefined;
+            const shouldSwitch = a.switch !== false;
+            const workspaceId = ws();
+            const thread = runtime.sessionThreads.upsert(workspaceId, {
+                title,
+                brief,
+                ...(id ? { id } : {}),
+            });
+            if (!thread) {
+                return { content: "thread_upsert: title required", isError: true };
+            }
+            if (shouldSwitch) {
+                runtime.sessionThreads.switchTo(workspaceId, sessionId, thread.id);
+            }
+            const affected = new Set(sessionIdsOnThread(runtime, workspaceId, thread.id));
+            affected.add(sessionId);
+            publishSessionThreads(runtime, workspaceId, [...affected]);
+            return { content: JSON.stringify({ workspaceId, thread }) };
+        },
+    });
+    registerTool(tools, {
+        name: "thread_switch",
+        description: "Attach this parent session to an existing workspace 主线 (same pin as a peer). " +
+            "Use after thread_list finds a matching 主线 instead of minting a duplicate.",
+        parameters: {
+            type: "object",
+            properties: { id: { type: "string" } },
+            required: ["id"],
+            additionalProperties: false,
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "thread_switch",
+            kind: "execute",
+            rawInput: args,
+        }),
+        execute: async (args) => {
+            const id = String(readArgs(args).id ?? "").trim();
+            const workspaceId = ws();
+            const bind = runtime.sessionThreads.switchTo(workspaceId, sessionId, id);
+            if (!bind) {
+                return { content: "thread_switch: unknown 主线 id", isError: true };
+            }
+            publishSessionThread(runtime, workspaceId, sessionId);
+            return { content: JSON.stringify({ workspaceId, bind }) };
+        },
+    });
+    registerTool(tools, {
+        name: "thread_delete",
+        description: "Delete a workspace 主线 you created and drop every session bind to it. " +
+            "Does not delete sessions. Only this workspace's catalog.",
+        parameters: {
+            type: "object",
+            properties: { id: { type: "string" } },
+            required: ["id"],
+            additionalProperties: false,
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "thread_delete",
+            kind: "execute",
+            rawInput: args,
+        }),
+        execute: async (args) => {
+            const id = String(readArgs(args).id ?? "").trim();
+            const workspaceId = ws();
+            const affected = sessionIdsOnThread(runtime, workspaceId, id);
+            const ok = runtime.sessionThreads.remove(workspaceId, id);
+            if (!ok) {
+                return { content: "thread_delete: unknown 主线 id", isError: true };
+            }
+            publishSessionThreads(runtime, workspaceId, affected);
+            return { content: JSON.stringify({ workspaceId, deleted: true, id }) };
+        },
+    });
+    registerTool(tools, {
+        name: "sideline_set",
+        description: "Write this session's 支线 caption (same as presence_set tips). " +
+            "Shows under the session name and on the Overview ball so the user sees what you are doing now. " +
+            "Does not change the session name. Does not require a 主线. Prefer presence_set when also changing emotion.",
+        parameters: {
+            type: "object",
+            properties: {
+                text: { type: "string", description: `Current work caption (≤${SIDELINE_MAX} chars).` },
+            },
+            required: ["text"],
+            additionalProperties: false,
+        },
+        isConcurrencySafe: () => true,
+        presentCall: (args) => ({
+            card: "generic",
+            title: "sideline_set",
+            kind: "other",
+            rawInput: args,
+        }),
+        execute: async (args) => {
+            const text = String(readArgs(args).text ?? "");
+            const workspaceId = ws();
+            const clipped = text.trim().slice(0, SIDELINE_MAX);
+            const bind = runtime.sessionThreads.bindOf(workspaceId, sessionId);
+            const next = bind
+                ? runtime.sessionThreads.setSideline(workspaceId, sessionId, clipped)
+                : bind;
+            const sticky = runtime.presence.get(sessionId);
+            runtime.presence.set(sessionId, {
+                emotionId: sticky?.emotionId ?? "30",
+                tips: clipped,
+            });
+            publishSessionThread(runtime, workspaceId, sessionId);
+            return { content: JSON.stringify({ workspaceId, bind: next ?? null, tips: clipped }) };
+        },
+    });
+}
+//# sourceMappingURL=session-thread-tools.js.map

package/node_modules/@xrkseek/server-face/dist/session-thread-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-thread-tools.js","sourceRoot":"","sources":["../src/session-thread-tools.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/settings-agent-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-agent-tools.d.ts","sourceRoot":"","sources":["../src/settings-agent-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,GACnB,IAAI,CA8FN"}
+{"version":3,"file":"settings-agent-tools.d.ts","sourceRoot":"","sources":["../src/settings-agent-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAchD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,GACnB,IAAI,CAwGN"}

package/node_modules/@xrkseek/server-face/dist/settings-agent-tools.js

@@ -5,6 +5,8 @@ import { createSettingsTools, } from "@xrkseek/core-tools";
 import { FACE_PRODUCT_SETTINGS_NAMESPACES } from "./settings-schemas.js";
 import { settingsDescribeFace, settingsMutateFace, } from "./settings-credentials.js";
 const AGENT_SETTINGS_NS = new Set(FACE_PRODUCT_SETTINGS_NAMESPACES.map((s) => s.ns));
+/** The Face-bound instances already installed on a registry (identity guard). */
+const faceBound = new WeakSet();
 export function bindSettingsTools(tools, runtime) {
     const bound = createSettingsTools({
         async get(ns) {
@@ -82,9 +84,19 @@ export function bindSettingsTools(tools, runtime) {
         },
     });
     for (const tool of bound) {
+        const prev = tools.get(tool.name);
         // Same identity rule as presence_set — see presence-tools.ts.
-        if (tools.get(tool.name))
+        if (prev && faceBound.has(prev))
             continue;
+        // Replace stub `settings_*` (registered by presets/standing tools with no
+        // Face impl) instead of skipping: getTool() serves the standing registry
+        // first, and its stub returns "unavailable (no Face channel)".
+        if (prev) {
+            faceBound.add(tool);
+            tools.replace(tool);
+            continue;
+        }
+        faceBound.add(tool);
         tools.register(tool);
     }
 }

package/node_modules/@xrkseek/server-face/dist/settings-agent-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-agent-tools.js","sourceRoot":"","sources":["../src/settings-agent-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings-agent-tools.js","sourceRoot":"","sources":["../src/settings-agent-tools.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/settings-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-document.d.ts","sourceRoot":"","sources":["../src/settings-document.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAUxE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEhE;AAUD,8EAA8E;AAC9E,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAiED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAWtE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAoBtE;AAeD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAQ9D;AAoED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhF;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlF;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,SAAS,CAgFpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC"}
+{"version":3,"file":"settings-document.d.ts","sourceRoot":"","sources":["../src/settings-document.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAoBhD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAUxE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEhE;AAUD,8EAA8E;AAC9E,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAiED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAWtE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAoBtE;AAeD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAQ9D;AAoED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhF;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlF;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,SAAS,CAgFpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC"}

package/node_modules/@xrkseek/server-face/dist/settings-document.js

@@ -7,6 +7,7 @@ import path from "node:path";
 import yaml from "js-yaml";
 import { resolveXrkHome } from "@xrkseek/server-config";
 import { FACE_PRODUCT_SETTINGS_NAMESPACES, schemaEnvelopeOf, } from "./settings-schemas.js";
+import { MEMBER_COLORS, MEMBER_KITS, MEMBER_SHAPES, } from "./agent-roster-store.js";
 import { FACE_AGENT_PRESET_IDS, canonicalAgentPresetId } from "./presets-catalog.js";
 import { isFacePermissionPreset, validateFaceFontSize, } from "./face-schema.js";
 import { listSettingsProviderCredentialRefs, providerApiKeyEnv, } from "./llm-provider-context.js";
@@ -338,22 +339,20 @@ export function validateSettingsNamespace(ns, merged) {
     }
     if (ns === "ui-presence") {
         const shape = merged.shape;
-        if (shape !== undefined &&
-            shape !== "blob" &&
-            shape !== "wedge" &&
-            shape !== "gem") {
+        if (shape !== undefined
+            && !MEMBER_SHAPES.includes(shape)) {
             return `unknown presence shape: ${String(shape)}`;
         }
         const color = merged.color;
-        if (color !== undefined &&
-            color !== "cream" &&
-            color !== "mist" &&
-            color !== "peach" &&
-            color !== "sage" &&
-            color !== "lilac" &&
-            color !== "slate") {
+        if (color !== undefined
+            && !MEMBER_COLORS.includes(color)) {
             return `unknown presence color: ${String(color)}`;
         }
+        const kit = merged.kit;
+        if (kit !== undefined
+            && !MEMBER_KITS.includes(kit)) {
+            return `unknown presence kit: ${String(kit)}`;
+        }
     }
     if (ns === "ssh-remote") {
         const host = String(merged.host ?? "").trim();