limixbot 0.3.24 → 0.3.25

package/dist-server/openmausbot.js

@@ -4193,7 +4193,7 @@ string(),skillManifestEntrySchema),stagedSkillWriteSchema=external_exports.objec
 /^[a-f0-9]{64}$/).optional(),warnings:external_exports.array(external_exports.string()),skippedFiles:external_exports.array(external_exports.string()),createdAt:external_exports.string(),baseSha256:external_exports.string().regex(/^[a-f0-9]{64}$/).optional(),baseAppliedStageId:external_exports.string().optional()}).superRefine((entry,ctx)=>{entry.action==="update"&&(!entry.baseSha256||!entry.baseAppliedStageId)&&ctx.addIssue({code:"custom",message:"updated skills require their reviewed base revi\
 sion"})}),stagedStoreSchema=external_exports.object({writes:external_exports.record(external_exports.string(),stagedSkillWriteSchema)})}});import{dirname as dirname29,isAbsolute as isAbsolute14,join as join64,resolve as resolve22}from"node:path";var IMPORTED_SKILLS_DIR,INDEX_PATH,sha256Hex,entrySchema,indexSchema,choicesSchema2,init_imported_skills=__esm({"server/imported-skills.ts"(){"use strict";init_zod();init_skill_fit();init_skill_md();init_atomic();init_config3();init_skill_storage();init_skills();IMPORTED_SKILLS_DIR=join64(DATA_DIR,"imported-skills"),INDEX_PATH=join64(DATA_DIR,"skill-state","imported-skills.json"),sha256Hex=
 external_exports.string().regex(/^[a-f0-9]{64}$/),entrySchema=external_exports.object({description:external_exports.string(),source:external_exports.enum(["claudeCode","codex"]),root:external_exports.string(),origin:external_exports.string(),label:external_exports.string(),sha256:sha256Hex,filesSha256:sha256Hex,importedAt:external_exports.string(),warnings:external_exports.array(external_exports.string()),license:external_exports.string().optional(),compatibility:external_exports.string().optional()}),
-indexSchema=external_exports.record(external_exports.string(),entrySchema),choicesSchema2=external_exports.object({off:external_exports.array(external_exports.string()),on:external_exports.record(external_exports.string(),sha256Hex).default({}),listed:external_exports.array(external_exports.string()).optional()})}});function parseToml(source){let text13=source.charCodeAt(0)===65279?source.slice(1):source,i2=0,root=table(),current=root,fail3=message5=>{throw new TomlError(`line ${text13.slice(0,i2).split(`
+indexSchema=external_exports.record(external_exports.string(),entrySchema),choicesSchema2=external_exports.object({off:external_exports.array(external_exports.string()),on:external_exports.record(external_exports.string(),sha256Hex).default({}),listed:external_exports.array(external_exports.string()).optional(),picked:external_exports.array(external_exports.string()).optional()})}});function parseToml(source){let text13=source.charCodeAt(0)===65279?source.slice(1):source,i2=0,root=table(),current=root,fail3=message5=>{throw new TomlError(`line ${text13.slice(0,i2).split(`
 `).length}: ${message5}`)},spaces=()=>{for(;text13[i2]===" "||text13[i2]==="	";)i2++},comment=()=>{if(text13[i2]==="#")for(;i2<text13.length&&text13[i2]!==`
 `;)i2++},newline=()=>{if(text13[i2]===`
 `)i2+=1;else if(text13[i2]==="\r"&&text13[i2+1]===`

package/dist-server/package.json

@@ -1 +1 @@
-{"type":"module","version":"0.3.24"}
+{"type":"module","version":"0.3.25"}

package/dist-server/pair-cli.js

@@ -4192,7 +4192,7 @@ string(),skillManifestEntrySchema),stagedSkillWriteSchema=external_exports.objec
 /^[a-f0-9]{64}$/).optional(),warnings:external_exports.array(external_exports.string()),skippedFiles:external_exports.array(external_exports.string()),createdAt:external_exports.string(),baseSha256:external_exports.string().regex(/^[a-f0-9]{64}$/).optional(),baseAppliedStageId:external_exports.string().optional()}).superRefine((entry,ctx)=>{entry.action==="update"&&(!entry.baseSha256||!entry.baseAppliedStageId)&&ctx.addIssue({code:"custom",message:"updated skills require their reviewed base revi\
 sion"})}),stagedStoreSchema=external_exports.object({writes:external_exports.record(external_exports.string(),stagedSkillWriteSchema)})}});import{dirname as dirname29,isAbsolute as isAbsolute14,join as join64,resolve as resolve22}from"node:path";var IMPORTED_SKILLS_DIR,INDEX_PATH,sha256Hex,entrySchema,indexSchema,choicesSchema2,init_imported_skills=__esm({"server/imported-skills.ts"(){"use strict";init_zod();init_skill_fit();init_skill_md();init_atomic();init_config3();init_skill_storage();init_skills();IMPORTED_SKILLS_DIR=join64(DATA_DIR,"imported-skills"),INDEX_PATH=join64(DATA_DIR,"skill-state","imported-skills.json"),sha256Hex=
 external_exports.string().regex(/^[a-f0-9]{64}$/),entrySchema=external_exports.object({description:external_exports.string(),source:external_exports.enum(["claudeCode","codex"]),root:external_exports.string(),origin:external_exports.string(),label:external_exports.string(),sha256:sha256Hex,filesSha256:sha256Hex,importedAt:external_exports.string(),warnings:external_exports.array(external_exports.string()),license:external_exports.string().optional(),compatibility:external_exports.string().optional()}),
-indexSchema=external_exports.record(external_exports.string(),entrySchema),choicesSchema2=external_exports.object({off:external_exports.array(external_exports.string()),on:external_exports.record(external_exports.string(),sha256Hex).default({}),listed:external_exports.array(external_exports.string()).optional()})}});function parseToml(source){let text13=source.charCodeAt(0)===65279?source.slice(1):source,i2=0,root=table(),current=root,fail3=message5=>{throw new TomlError(`line ${text13.slice(0,i2).split(`
+indexSchema=external_exports.record(external_exports.string(),entrySchema),choicesSchema2=external_exports.object({off:external_exports.array(external_exports.string()),on:external_exports.record(external_exports.string(),sha256Hex).default({}),listed:external_exports.array(external_exports.string()).optional(),picked:external_exports.array(external_exports.string()).optional()})}});function parseToml(source){let text13=source.charCodeAt(0)===65279?source.slice(1):source,i2=0,root=table(),current=root,fail3=message5=>{throw new TomlError(`line ${text13.slice(0,i2).split(`
 `).length}: ${message5}`)},spaces=()=>{for(;text13[i2]===" "||text13[i2]==="	";)i2++},comment=()=>{if(text13[i2]==="#")for(;i2<text13.length&&text13[i2]!==`
 `;)i2++},newline=()=>{if(text13[i2]===`
 `)i2+=1;else if(text13[i2]==="\r"&&text13[i2+1]===`

package/dist-server/server/imported-skills.js

@@ -47,6 +47,8 @@ const choicesSchema = z.object({
     off: z.array(z.string()),
     on: z.record(z.string(), sha256Hex).default({}),
     listed: z.array(z.string()).optional(),
+    /** Limix Bot: skills from this computer are off for a bot until a person adds one from its store. */
+    picked: z.array(z.string()).optional(),
 });
 /** Every imported skill by name; empty when there are none or the index cannot be trusted. */
 export function readImportedSkills() {
@@ -279,6 +281,8 @@ export function storeImportedSkills(inputs) {
 function enabledFor(name, entry, choices) {
     if (choices.off.includes(name))
         return false;
+    if (!(choices.picked ?? []).includes(name))
+        return false;
     return entry.warnings.length === 0 || choices.on[name] === entry.filesSha256;
 }
 const comparable = (path) => {
@@ -361,9 +365,10 @@ export function setImportedSkillEnabled(botId, name, enabled) {
     const off = choices.off.filter((other) => other !== name);
     const { [name]: _read, ...on } = choices.on;
     const listed = choices.listed?.filter((other) => other !== name);
+    const picked = (choices.picked ?? []).filter((other) => other !== name);
     const next = enabled
-        ? { off, on: entry.warnings.length ? { ...on, [name]: entry.filesSha256 } : on, ...(listed ? { listed: [...listed, name].sort() } : {}) }
-        : { off: [...off, name].sort(), on, ...(listed ? { listed } : {}) };
+        ? { off, on: entry.warnings.length ? { ...on, [name]: entry.filesSha256 } : on, ...(listed ? { listed: [...listed, name].sort() } : {}), picked: [...picked, name].sort() }
+        : { off: [...off, name].sort(), on, ...(listed ? { listed } : {}), picked };
     mkdirSync(dirname(choicesPath(botId)), { recursive: true, mode: 0o700 });
     writeFileAtomic(choicesPath(botId), `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
     return importedSkillListings(botId, new Set()).find((skill) => skill.name === name);

package/dist-server/server/index.js

@@ -442,7 +442,7 @@ import { AGENTS_NODE_FLAG, SPAWNED_PROXIES } from "./proxy-paths.js";
 import { agentsProxyLaunch, agentsToolBridgeEnv, applyAgentsBridge, bridgedToolTitle, turnEngine } from "./agents-bridge-switch.js";
 import { agentsServerEnv, botDrivenConversation, COMPUTER_OFF_REFUSAL, computerPickRefusal, directTurnKind, roomSkillsRefusal } from "./agents-turn.js";
 import { harnessMcpTokenEnv } from "./harness-mcp-token.js";
-import { loadBundledSkills, loadUserSkills, mergeSkills, renderSkillInstructions, selectBundledSkills, skillsLibraryEnabled, readSkillLibraryIndex, } from "./skill-library.js";
+import { loadBundledSkills, loadUserSkills, mergeSkills, renderSkillInstructions, skillsLibraryEnabled, readSkillLibraryIndex, } from "./skill-library.js";
 import { runSkillsLibraryBootSweep } from "./skills-library-migration.js";
 import { installedPlaybookInstructions } from "./installed-playbooks.js";
 import { picture as sharedPicture } from "./package-export.js";
@@ -512,6 +512,7 @@ import { createBotOrderRoutes } from "./routes/bot-order.js";
 import { createBotLifecycleRoutes } from "./routes/bot-lifecycle.js";
 import { createBotSkillsRoutes } from "./routes/bot-skills.js";
 import { startHubAutoSync } from "./limix-skill-hub.js";
+import { limixBundledFor, limixSelectBundled, limixSkillDefaultsMigration } from "./limix-skill-store.js";
 import { createSkillShareRoutes } from "./routes/skill-share.js";
 import { createTeamContextRoutes } from "./routes/team-context.js";
 import { createAppSuggestions } from "./host/app-suggestions.js";
@@ -1436,6 +1437,7 @@ function resyncOpenCodeProviderKeys() {
 const firstEngineRead = holdUntilFirstEngineRead();
 await registry.load(providerConfigs(), decorateHostedProvider);
 const bundledSkills = loadBundledSkills();
+limixSkillDefaultsMigration();
 const availableSkills = () => mergeSkills(bundledSkills, loadUserSkills(join(DATA_DIR, "skills")));
 /** Every turn the engine can mount it, whatever its words: they pick only the skill's instructions. A Cloud home or a hosted workspace has no USB port. */
 const usbPhoneOffered = (instance, skills) => instance.adapter.capabilities.phoneMcp === true &&
@@ -8084,8 +8086,8 @@ async function beginTurn(botId, text, opts) {
                 handoffs.begin(threadId, dispatchClaimId, dispatchContext.handoff);
             const integrations = {};
             let browser = null;
-            const skills = availableSkills(), phoneOffered = usbPhoneOffered(instance, skills) && !proactive.fence.confines(threadId) && !botApiThread(threadId);
-            const selectedSkills = selectBundledSkills(providerText, [
+            const skills = limixBundledFor(bot.id, availableSkills()), phoneOffered = usbPhoneOffered(instance, skills) && !proactive.fence.confines(threadId) && !botApiThread(threadId);
+            const selectedSkills = limixSelectBundled(providerText, [
                 ...(phoneOffered ? ["phoneMcp"] : []),
                 ...(skillAuthoring ? ["skillAuthoring"] : []),
             ], skills);
@@ -10048,8 +10050,8 @@ setupRetry = 0) {
             : undefined, bot.id);
         const roomContext = roomWindow.text;
         const turnImages = usesNativeImageInput ? [...burstImages, ...resolvedLatestImages.images, ...await videoFramesWithin(burstImages.length + resolvedLatestImages.images.length, resolvedLatestImages.videos)] : [];
-        const skills = availableSkills(), phoneOffered = usbPhoneOffered(instance, skills);
-        const selectedSkills = mergeSkills(selectBundledSkills(roomContext, phoneOffered ? ["phoneMcp"] : [], skills), selectBundledSkills(latestUser?.text ?? "", skillAuthoring ? ["skillAuthoring"] : [], skills));
+        const skills = limixBundledFor(bot.id, availableSkills()), phoneOffered = usbPhoneOffered(instance, skills);
+        const selectedSkills = mergeSkills(limixSelectBundled(roomContext, phoneOffered ? ["phoneMcp"] : [], skills), limixSelectBundled(latestUser?.text ?? "", skillAuthoring ? ["skillAuthoring"] : [], skills));
         if (phoneOffered)
             integrations.phone = phoneIntegration(bot.id, threadId, internalGeneration);
         try {

package/dist-server/server/limix-bot-library.js

@@ -123,6 +123,12 @@ export function parseLibraryBot(value, expectedId) {
                 schedule: { type: "daily", time, weekdays: [...new Set(weekdays)].sort() }, enabled: false, overlap: "skip" };
         });
     }
+    if (value.skills !== undefined) {
+        if (!Array.isArray(value.skills) || value.skills.length > 20 || value.skills.some((name) => typeof name !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name) || name.length > 64)) {
+            throw new Error("skills is invalid");
+        }
+        bot.skills = [...new Set(value.skills)];
+    }
     return bot;
 }
 async function fetchJson(url, maxBytes) {

package/dist-server/server/limix-skill-hub.js

@@ -1,6 +1,6 @@
 // Limix Skill Hub client: keeps a cached copy of the hub catalog, installs a skill only after every file matches the
 // SHA-256 the catalog pins, and never installs scripts, binaries or MCP files unless the owner allows tools for that
-// one skill. Installed skills land DISABLED; the owner turns them on. Auto Sync (catalog refresh) is on by default,
+// one skill. Installed skills wait in the store ("Kho Kĩ Năng (Skills)"), switched on but on no bot until one is added to it. Auto Sync (catalog refresh) is on by default,
 // Auto Install is off by default.
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
@@ -171,7 +171,7 @@ export async function installHubSkill(id, options = {}) {
         ...(entry.tags.length ? { tags: entry.tags } : {}),
         warnings: entry.notes,
         skippedFiles: skipped,
-        reviewState: "disabled",
+        reviewState: "approved",
         ...(files.length ? { files } : {}),
     });
     if ("error" in result)

package/dist-server/server/limix-skill-store.js

@@ -0,0 +1,179 @@
+// Limix Bot: skills are chosen per bot. A new bot starts with only Limix's core skills (learning new skills, reading
+// links with Agent Reach, operating Windows, the phone helpers) plus the skills it learns itself; everything else waits
+// in the store ("Kho Kĩ Năng (Skills)") until a person adds it to one bot. Settings → Kĩ Năng (Skills) only downloads and
+// installs skills into the store; it never turns a skill on for every bot.
+//
+// Three kinds of skill can be added to a bot from the store:
+//   bundled  — shipped in skills/<id> (ui-ux-pro-max, data-dashboards…): the bot's picks live in
+//              <data>/skill-state/<bot>/limix-bundled.json; core ones are always on and cannot be removed.
+//   library  — installed from the Limix Skill Hub or pasted in Settings: the bot's assignedSkills.
+//   imported — brought in from this computer's Claude Code or Codex: the bot's own switch (opt-in in Limix).
+// `/name` calls any skill the bot has, bundled ones included (limixSelectBundled).
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { isSkillName } from "../shared/skill-md.js";
+import { writeFileAtomic } from "./atomic.js";
+import { DATA_DIR } from "./config.js";
+import { importedSkillListings, setImportedSkillEnabled } from "./imported-skills.js";
+import { listLibrarySkills, loadBundledSkills, mergeSkills, readSkillLibraryIndex, selectBundledSkills, setLibrarySkillEveryBot, setLibrarySkillOptOut, setLibrarySkillReviewState, unassignLibrarySkill, } from "./skill-library.js";
+/** Always on for every bot. "Learning new skills" itself is the skill-authoring feature, on for every bot already. */
+export const LIMIX_CORE_SKILLS = new Set([
+    "create-verification-skill", "agent-reach", "windows-computer-automation", "phone-connection", "phone-harness",
+]);
+const BOT_ID = /^[\w-]+$/;
+const picksPath = (botId) => join(DATA_DIR, "skill-state", botId, "limix-bundled.json");
+export function bundledPicks(botId) {
+    if (!BOT_ID.test(botId))
+        return new Set();
+    try {
+        const parsed = JSON.parse(readFileSync(picksPath(botId), "utf8"));
+        return new Set(Array.isArray(parsed) ? parsed.filter((name) => typeof name === "string" && isSkillName(name)) : []);
+    }
+    catch {
+        return new Set();
+    }
+}
+function setBundledPick(botId, id, on) {
+    if (!BOT_ID.test(botId) || !isSkillName(id))
+        return;
+    const picks = bundledPicks(botId);
+    if (picks.has(id) === on)
+        return;
+    if (on)
+        picks.add(id);
+    else
+        picks.delete(id);
+    mkdirSync(join(DATA_DIR, "skill-state", botId), { recursive: true, mode: 0o700 });
+    writeFileAtomic(picksPath(botId), `${JSON.stringify([...picks].sort(), null, 2)}\n`, { mode: 0o600 });
+}
+/** The shipped skills one bot has: the core ones and the ones a person added to it. */
+export function limixBundledFor(botId, skills) {
+    const picks = bundledPicks(botId);
+    return skills.filter(({ manifest }) => LIMIX_CORE_SKILLS.has(manifest.id) || picks.has(manifest.id));
+}
+const slashCalled = (text, id) => new RegExp(`(^|\\s)/${id.replace(/[-]/g, "\\-")}(?=$|[\\s.,:;!?])`, "m").test(text);
+/** selectBundledSkills, plus every skill of `skills` the text calls by `/id`. */
+export function limixSelectBundled(text, capabilities, skills) {
+    const available = new Set(capabilities);
+    const called = skills.filter(({ manifest }) => manifest.requiredCapabilities.every((capability) => available.has(capability)) && slashCalled(text, manifest.id));
+    return mergeSkills(selectBundledSkills(text, available, skills), called);
+}
+/** The bot's shipped skills as rows of its Skills page. */
+export function limixBundledListings(botId) {
+    return limixBundledFor(botId, loadBundledSkills()).map(({ manifest }) => ({
+        name: manifest.id, description: manifest.description, enabled: true, editable: false,
+        source: LIMIX_CORE_SKILLS.has(manifest.id) ? "Kĩ năng gốc của Limix Bot" : "Kho Kĩ Năng (Skills) · có sẵn",
+        sha256: "", importedAt: "", warnings: [], skippedFiles: [], origin: "bundled", core: LIMIX_CORE_SKILLS.has(manifest.id),
+    }));
+}
+/** A bot's switch for one of its shipped skills: off takes an added one away; a core one stays. Null: not shipped. */
+export function limixBundledSwitch(botId, name, enabled) {
+    if (!loadBundledSkills().some(({ manifest }) => manifest.id === name))
+        return null;
+    if (LIMIX_CORE_SKILLS.has(name)) {
+        return enabled ? { status: 200, body: { skill: limixBundledListings(botId).find((skill) => skill.name === name) } }
+            : { status: 409, body: { error: "Kĩ năng gốc của Limix Bot luôn bật cho mọi bot." } };
+    }
+    setBundledPick(botId, name, enabled);
+    return { status: 200, body: { skill: { ...limixBundledListings(botId).find((skill) => skill.name === name), name, enabled } } };
+}
+function storeItems(bots, botId) {
+    const bot = bots.bot(botId);
+    const assigned = new Set(bot.assignedSkills ?? []);
+    const picks = bundledPicks(botId);
+    const items = new Map();
+    for (const { manifest } of loadBundledSkills()) {
+        const core = LIMIX_CORE_SKILLS.has(manifest.id);
+        items.set(manifest.id, { name: manifest.id, description: manifest.description, kind: "bundled", added: core || picks.has(manifest.id), core, ready: true, warnings: 0, source: "Có sẵn trong Limix Bot" });
+    }
+    for (const skill of listLibrarySkills()) {
+        if (items.has(skill.name))
+            continue;
+        const intact = !skill.warnings.some((warning) => warning.includes("enablement is blocked"));
+        items.set(skill.name, {
+            name: skill.name, description: skill.description, kind: "library", added: assigned.has(skill.name) && skill.enabled, core: false,
+            ready: intact, warnings: skill.warnings.length, source: skill.source.startsWith("limix-hub:") ? "Thư viện kĩ năng Limix" : "Đã cài trong Cài đặt",
+        });
+    }
+    for (const skill of importedSkillListings(botId, new Set())) {
+        if (items.has(skill.name))
+            continue;
+        items.set(skill.name, { name: skill.name, description: skill.description, kind: "imported", added: skill.enabled, core: false, ready: true, warnings: skill.warnings.length, source: skill.source || "Từ máy tính này" });
+    }
+    return [...items.values()].sort((a, b) => Number(b.core) - Number(a.core) || a.name.localeCompare(b.name));
+}
+/** Add one skill to one bot, or take it away. `kind` may be left out: the store finds the name. */
+export function limixStoreSet(bots, botId, name, add, kind) {
+    const bot = bots.bot(botId);
+    if (!bot)
+        return { error: "Không tìm thấy bot." };
+    if (!isSkillName(name))
+        return { error: "Tên kĩ năng không hợp lệ." };
+    const item = storeItems(bots, botId).find((entry) => entry.name === name && (!kind || entry.kind === kind));
+    if (!item)
+        return { error: `Kho chưa có kĩ năng "${name}".` };
+    if (item.kind === "bundled") {
+        if (item.core)
+            return add ? { ok: true } : { error: "Kĩ năng gốc của Limix Bot luôn bật cho mọi bot." };
+        setBundledPick(botId, name, add);
+        return { ok: true };
+    }
+    if (item.kind === "imported") {
+        const result = setImportedSkillEnabled(botId, name, add);
+        return "error" in result ? { error: result.error } : { ok: true };
+    }
+    const assigned = bot.assignedSkills ?? [];
+    if (add) {
+        // Adding from the store is the person's choice for this bot, so a skill installed but not yet switched on is switched on.
+        const listing = listLibrarySkills().find((skill) => skill.name === name);
+        if (listing && !listing.enabled) {
+            const approved = setLibrarySkillReviewState(name, "approved");
+            if ("error" in approved)
+                return { error: approved.error };
+        }
+        setLibrarySkillOptOut(botId, name, false);
+        if (!assigned.includes(name))
+            bots.patchBot(botId, { assignedSkills: [...assigned, name] });
+        return { ok: true };
+    }
+    const result = unassignLibrarySkill(botId, name, assigned);
+    if ("unassigned" in result && result.assignedSkills)
+        bots.patchBot(botId, { assignedSkills: result.assignedSkills });
+    return { ok: true };
+}
+/** GET /api/limix/skill-store/<bot> lists the store for that bot; POST {name, add, kind?} adds or takes away one skill. */
+export function handleLimixSkillStore(bots, method, path, body) {
+    const m = path.match(/^\/api\/limix\/skill-store\/([\w-]+)$/);
+    if (!m)
+        return null;
+    const botId = m[1];
+    if (!bots.bot(botId))
+        return { status: 404, body: { error: "Không tìm thấy bot." } };
+    if (method === "GET")
+        return { status: 200, body: { skills: storeItems(bots, botId) } };
+    if (method === "POST") {
+        const raw = (body && typeof body === "object" ? body : {});
+        const kind = raw.kind === "bundled" || raw.kind === "library" || raw.kind === "imported" ? raw.kind : undefined;
+        if (typeof raw.name !== "string" || typeof raw.add !== "boolean")
+            return { status: 400, body: { error: "Cần tên kĩ năng và add." } };
+        const result = limixStoreSet(bots, botId, raw.name, raw.add, kind);
+        return "error" in result ? { status: 422, body: result } : { status: 200, body: { skills: storeItems(bots, botId) } };
+    }
+    return { status: 405, body: { error: "method not allowed" } };
+}
+/** Once: skills that earlier versions turned on for every bot go back to the store. */
+export function limixSkillDefaultsMigration() {
+    const marker = join(DATA_DIR, "skill-state", "limix-skill-defaults-v1.json");
+    if (existsSync(marker))
+        return;
+    try {
+        for (const [name, entry] of Object.entries(readSkillLibraryIndex()))
+            if (entry.everyBot)
+                setLibrarySkillEveryBot(name, false);
+        mkdirSync(join(DATA_DIR, "skill-state"), { recursive: true, mode: 0o700 });
+        writeFileAtomic(marker, `${JSON.stringify({ at: new Date().toISOString() })}\n`, { mode: 0o600 });
+    }
+    catch {
+        // Retried at the next start.
+    }
+}

package/dist-server/server/routes/bot-skills.js

@@ -7,6 +7,7 @@ import { fetchSkillFromSource } from "../skill-fetch.js";
 import { readLocalSkills } from "../limix-skill-folder.js";
 import { loadBundledSkills } from "../skill-library.js";
 import { handleLimixHub } from "../limix-skill-hub.js";
+import { handleLimixSkillStore, LIMIX_CORE_SKILLS, limixBundledListings, limixBundledSwitch } from "../limix-skill-store.js";
 import { skillImportSummary } from "../skill-folder.js";
 import { installLibrarySkill, librarySkillOptOuts, listLibrarySkills, readLibrarySkillFile, readSkillLibraryIndex, setLibrarySkillEveryBot, setLibrarySkillOptOut, setLibrarySkillReviewState, skillsLibraryEnabled, unassignLibrarySkill } from "../skill-library.js";
 import { installSkill, listBotSkillsWithOrigin, listStagedSkillWrites, parseSkillMd, removeSkill, scanSkillText, setSkillEnabled, } from "../skills.js";
@@ -25,8 +26,13 @@ export function createBotSkillsRoutes(deps) {
             if (hub)
                 return json(res, hub.status, hub.body);
         }
+        if (path.startsWith("/api/limix/skill-store/")) {
+            const skillStore = handleLimixSkillStore(store, method, path, method === "POST" ? await readBody(req) : undefined);
+            if (skillStore)
+                return json(res, skillStore.status, skillStore.body);
+        }
         if (method === "GET" && path === "/api/limix/bundled-skills") {
-            const skills = loadBundledSkills().map(({ manifest }) => ({ id: manifest.id, name: manifest.name, description: manifest.description, defaultEnabled: manifest.defaultEnabled, triggerTerms: manifest.triggerTerms }));
+            const skills = loadBundledSkills().map(({ manifest }) => ({ id: manifest.id, name: manifest.name, description: manifest.description, defaultEnabled: manifest.defaultEnabled, triggerTerms: manifest.triggerTerms, core: LIMIX_CORE_SKILLS.has(manifest.id) }));
             return json(res, 200, { skills });
         }
         // Imports land DISABLED: a person enables one after reading SKILL.md and its scan warnings.
@@ -63,14 +69,15 @@ export function createBotSkillsRoutes(deps) {
                 const { skills, library } = listBotSkillsWithOrigin(m[1], store.bot(m[1]).assignedSkills);
                 const names = new Set(skills.map((skill) => skill.name));
                 return json(res, 200, {
-                    skills: [...skills, ...listBotSkills(bot, threadId).filter((skill) => !names.has(skill.name))],
+                    skills: [...skills, ...listBotSkills(bot, threadId).filter((skill) => !names.has(skill.name)),
+                        ...limixBundledListings(bot.id).filter((skill) => !names.has(skill.name) && !listBotSkills(bot, threadId).some((other) => other.name === skill.name))],
                     library,
                     assignedSkills: store.bot(m[1]).assignedSkills,
                     staged: listStagedSkillWrites(m[1]).map(stagedSkillListing),
                 });
             }
             return json(res, 200, {
-                skills: listBotSkills(bot, threadId),
+                skills: [...listBotSkills(bot, threadId), ...limixBundledListings(bot.id)],
                 staged: listStagedSkillWrites(m[1]).map(stagedSkillListing),
             });
         }
@@ -121,8 +128,12 @@ export function createBotSkillsRoutes(deps) {
                 return json(res, 200, { skill });
             }
             const result = setSkillEnabled(m[1], m[2], parsed.data.enabled);
-            if ("error" in result)
+            if ("error" in result) {
+                const shipped = limixBundledSwitch(m[1], m[2], parsed.data.enabled);
+                if (shipped)
+                    return json(res, shipped.status, shipped.body);
                 return json(res, 404, { error: result.error });
+            }
             return json(res, 200, { skill: result });
         }
         if (m && method === "DELETE") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "limixbot",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "description": "Run the Limix Bot server anywhere and pair your devices to it (Leox ৹ Limix AI)",
   "license": "Apache-2.0",
   "type": "module",

package/skills/windows-computer-automation/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: windows-computer-automation
+description: Điều phối AI Agent hoặc Bot điều khiển Windows trong Herionix qua Agent Desktop và Windows-MCP. Dùng khi cần đọc màn hình, thao tác cửa sổ, nhập liệu, trình duyệt, quản lý ứng dụng, file hoặc tiến trình; lựa chọn tool phù hợp, quản lý quyền, tránh bot giành chuột, xác minh kết quả và chống lặp thao tác. Hỗ trợ thiết kế hoặc khắc phục tích hợp hai MCP Server vào ứng dụng AI nhiều agent.
+---
+
+# Windows Computer Automation — Herionix
+
+## Mục tiêu
+
+Dùng **Agent Desktop** cho phần tử giao diện Windows dựa trên accessibility tree; dùng **Windows-MCP** cho công cụ hệ thống, filesystem, app, process và dự phòng UI khi thích hợp. Đây là Skill hướng dẫn điều phối: **không tự cài MCP Server hoặc cấp quyền cho máy**. Chỉ thực thi khi Herionix đã kết nối thực tế với các MCP Server và tool được cấp phép.
+
+## Quy trình bắt buộc
+
+1. **Xác định nhiệm vụ và giới hạn:** Xác nhận ứng dụng/cửa sổ, đầu vào/đầu ra, đường dẫn file, hành động cuối cùng có được phép thực hiện không. Phân biệt chỉ đọc với thay đổi hệ thống.
+2. **Khám phá năng lực thật:** Lấy `list_tools` của hai MCP Server; không giả định tool có mặt chỉ vì tài liệu có tên. Kiểm tra trạng thái desktop, hệ điều hành, phiên đăng nhập và quyền. Nếu thiếu connector, dừng và thông báo cụ thể; không giả vờ đã thao tác.
+3. **Kiểm tra rủi ro:** Đọc [references/security.md](references/security.md). Những tác vụ xóa/ghi đè, chạy lệnh, sửa Registry, gửi nội dung ra ngoài, thanh toán, đổi quyền hoặc tắt tiến trình cần quyết định theo policy của host. Model **không tự phê duyệt**. Host phải chặn hành động trước khi gọi tool.
+4. **Điều phối một desktop:** Một `desktop_id` chỉ được có **một agent giữ quyền ghi/nhập liệu** tại một thời điểm; khóa ở backend Herionix, không chỉ trong prompt. Nhiều agent có thể lập kế hoạch/đọc nếu đọc không cản trở; việc ghi phải đi qua hàng đợi.
+5. **Quan sát trước khi thao tác:** Ưu tiên accessibility tree, ref và window ID; tránh tọa độ nếu còn lựa chọn định danh ổn định. Chọn provider theo bảng dưới đây và [references/routing.md](references/routing.md).
+6. **Thực thi tối thiểu:** Mỗi lần chỉ thực thi bước cần thiết. Không gọi song song hai tool nhập liệu. Sử dụng key chống trùng `task_id + step_id + target + desired_effect` do backend cấp.
+7. **Xác minh sau thao tác:** Đọc lại phần tử/trạng thái/file hoặc kết quả tương ứng, xác nhận hậu điều kiện. `tool returned success` không đồng nghĩa công việc đã hoàn thành.
+8. **Phục hồi có giới hạn:** Với `STALE_REF`/`AMBIGUOUS_TARGET`, làm mới snapshot và định vị lại. Chỉ retry khi upstream công bố an toàn hoặc hậu điều kiện chứng minh chưa xảy ra tác dụng phụ. Dừng sau tối đa **1 retry kỹ thuật** cho một bước, hoặc **2 chu kỳ không tiến triển**; không gọi vòng lặp vô hạn, không tự `microcompact` để che lỗi.
+9. **Báo cáo:** Trả lời ngắn bằng tiếng Việt: việc đã làm/đã xác minh, file được tạo (nếu có), bước chưa hoàn tất, các phê duyệt cần thiết, lỗi và bằng chứng không nhạy cảm. Không ghi log ảnh/chụp clipboard chứa bí mật.
+
+## Chọn công cụ
+
+| Tình huống | Ưu tiên | Dự phòng / điều kiện |
+|---|---|---|
+| Đọc/nhấn/nhập trên UI có ref định danh | Agent Desktop: `desktop_snapshot`, `desktop_click`, `desktop_type`... | Windows-MCP `Snapshot` + `Click`/`Type` sau khi định vị mới |
+| Giao diện không xuất accessibility hoặc điều khiển tọa độ | Windows-MCP `Snapshot` / `Screenshot`, `Click`, `Type` | Agent Desktop `--headed` chỉ khi cần và được phép |
+| Khởi động, chuyển cửa sổ ứng dụng | Windows-MCP `App` | Agent Desktop `desktop_launch` / window tools nếu có |
+| Xem, ghi file trong thư mục được cho phép | Windows-MCP `FileSystem` | Không thay bằng UI nếu có API/file-tool tin cậy |
+| Kiểm tra tiến trình | Windows-MCP `Process` (chỉ list) | Terminate yêu cầu xác nhận từ host |
+| PowerShell / Registry | **Mặc định không mở quyền** | Chỉ bật có chủ đích trong môi trường kiểm soát, qua host approval |
+| Trang web cần DOM | Windows-MCP `Snapshot` (`use_dom` nếu phiên bản hỗ trợ) | Với luồng web phức tạp, cân nhắc browser automation chuyên biệt |
+
+**Không chuyển provider để retry mù:** Sau lỗi của một thao tác có tác dụng phụ, phải quan sát và xác minh trạng thái trước khi quyết định bước tiếp theo.
+
+## Luồng chống tốn token
+
+- Lưu `window_id`, `snapshot_id`, mục tiêu và tóm tắt trạng thái ngắn; **vô hiệu** ref cũ sau mỗi thay đổi UI.
+- Không gửi ảnh toàn màn hình ở mọi bước; dùng tree compact, vùng chụp nhỏ hoặc snapshot theo app.
+- Chỉ tiếp tục khi có `progress marker` mới (trạng thái thay đổi, file xuất hiện, nút đổi trạng thái, trang chuyển); nếu hai lần không có tiến triển, dừng và báo lỗi.
+- Nếu hai agent cùng xin điều khiển, chỉ một agent thực thi; agent còn lại chờ hoặc làm việc không tác động desktop.
+
+## Kết nối và kiểm thử
+
+- Tham khảo [references/herionix-integration.md](references/herionix-integration.md) để cài và kết nối hai MCP Server qua stdio.
+- Dùng [assets/mcp-servers.example.json](assets/mcp-servers.example.json) làm cấu hình minh họa, **không coi là file cấu hình Herionix chính thức**.
+- Có thể dùng `scripts/policy_engine.py` làm ví dụ bộ định tuyến/rào chắn **không có quyền tự thực thi OS**; backend phải thực hiện kiểm tra policy, khóa và approval thật. Ví dụ và kiểm thử: [references/scenarios.md](references/scenarios.md).
+
+## Cách ứng xử khi không có quyền điều khiển máy
+
+Trình bày kế hoạch, lệnh cấu hình hoặc code phù hợp; nói rõ chưa thi hành và chưa xác minh trên Windows thật. Không tuyên bố đã tích hợp vào máy hay Herionix nếu chưa có truy cập đến mã nguồn và runtime của ứng dụng.

package/skills/windows-computer-automation/assets/HERIONIX-LEADER-PROMPT.md

@@ -0,0 +1,25 @@
+# Prompt dành cho Leader — triển khai Windows Computer Automation vào Herionix
+
+Bạn là Leader kỹ thuật của dự án Herionix (desktop Windows). Hãy tích hợp Skill `windows-computer-automation` đính kèm vào hệ thống Bot/Teammate. Mục tiêu: mỗi bot được sử dụng có phân quyền cả Agent Desktop MCP và Windows-MCP; không có hai bot cùng tác động input trên một Windows interactive session.
+
+## Quy tắc làm việc
+
+1. Kiểm tra cấu trúc mã nguồn Herionix và cơ chế MCP/Tool/Skill hiện có; không đoán framework, đường dẫn hay version. Lập kế hoạch ngắn, phân task cho Teammate phù hợp, chỉ thay đổi các file cần thiết.
+2. Đọc `SKILL.md`, `references/herionix-integration.md`, `references/security.md`, `references/routing.md` trong gói Skill; dùng file `assets/mcp-servers.example.json` như cấu hình tham khảo, không giả định schema Herionix tương thích.
+3. Kết nối Agent Desktop (`agent-desktop mcp`) và Windows-MCP (`uvx windows-mcp serve` qua stdio). Cần kiểm tra `list_tools` động, healthcheck, startup/shutdown, timeout, lỗi transport; không spawn server trùng lặp cho từng bot dùng chung desktop.
+4. Xây các module `ToolRegistry`, `ComputerControlManager`, `AuthorizationService`, `DesktopSessionScheduler`, `ExecutionLedger`, `Verifier` hoặc tương đương với kiến trúc dự án.
+5. Ưu tiên Agent Desktop cho thao tác có ref accessibility; Windows-MCP cho App/FileSystem/Process và fallback UI. Quan sát trước thao tác, xác minh hậu điều kiện sau thao tác. Không retry mù sau side effect.
+6. Bảo vệ ở backend: allowlist đường dẫn đã canonicalize trên Windows, quyền tool từng bot, approval UI do người dùng xác nhận, disable PowerShell/Registry mặc định, khóa single-writer desktop, idempotency từng step, max 1 retry kỹ thuật + 2 vòng không tiến triển. Model không được tự gửi cờ phê duyệt để vượt policy.
+7. UI tiếng Việt trong `Tools > Windows Computer Automation`: bật/tắt providers, trạng thái kết nối, chọn thư mục cho phép, quyền Bot, hàng đợi đang giữ desktop, log tối giản, nút Dừng khẩn cấp.
+8. Bổ sung unit/integration tests cho đúng 8 kịch bản trong `references/herionix-integration.md`; thử nghiệm khi không có GUI session, khi MCP server crash, khi ref UI stale và khi người dùng điều khiển chuột.
+9. Không phá module Hermes, AionUI Teamate, các cấu hình Bot hoặc dữ liệu người dùng. Không expose MCP ra mạng công khai.
+
+## Tiêu chuẩn hoàn tất
+
+- Có code thực thi trong Herionix, không chỉ prompt hoặc file SKILL.md.
+- Bot có thể chọn provider theo nhiệm vụ, nhưng mọi desktop input được serialize.
+- Không có quyền ngoài allowlist; thao tác rủi ro cần approval thật từ UI host.
+- Unit + integration tests đạt, báo cáo file thay đổi và cách chạy.
+- Không tuyên bố đã test GUI thật nếu chỉ chạy mock tests.
+
+Hãy bắt đầu bằng việc khám phá codebase, trình bày ngắn những module hiện có và triển khai theo từng phần kiểm chứng được. Không hỏi lại những thông tin đã thể hiện trong mã nguồn.

package/skills/windows-computer-automation/assets/control-policy.example.json

@@ -0,0 +1,25 @@
+{
+  "available": {
+    "agent_desktop": true,
+    "windows_mcp": true
+  },
+  "allowed_write_roots": [
+    "C:\\Users\\Public\\Documents\\Herionix-Exports"
+  ],
+  "system_tools_enabled": false,
+  "allow_executable_launch": false,
+  "max_retries_per_step": 1,
+  "max_no_progress_cycles": 2,
+  "require_host_confirmation_for": [
+    "delete",
+    "overwrite",
+    "send",
+    "upload",
+    "purchase",
+    "security_change",
+    "terminate_process"
+  ],
+  "allowed_read_roots": [
+    "C:\\Users\\Public\\Documents\\Herionix-Exports"
+  ]
+}

package/skills/windows-computer-automation/assets/mcp-servers.example.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "agent-desktop": {
+      "command": "agent-desktop",
+      "args": ["mcp"]
+    },
+    "windows-mcp": {
+      "command": "uvx",
+      "args": [
+        "windows-mcp",
+        "serve",
+        "--exclude-tools",
+        "PowerShell,Registry",
+        "--control-policy",
+        "balanced"
+      ]
+    }
+  }
+}

package/skills/windows-computer-automation/manifest.json

@@ -0,0 +1,27 @@
+{
+  "id": "windows-computer-automation",
+  "name": "Windows Computer Automation",
+  "version": "1.0.0",
+  "description": "Điều khiển Windows an toàn: đọc màn hình, thao tác cửa sổ, nhập liệu, trình duyệt, ứng dụng, tệp và tiến trình qua Agent Desktop và Windows-MCP; chọn đúng công cụ, xác minh kết quả, chống lặp thao tác.",
+  "defaultEnabled": true,
+  "triggerTerms": [
+    "windows-computer-automation",
+    "điều khiển máy tính",
+    "điều khiển windows",
+    "thao tác trên máy",
+    "thao tác máy tính",
+    "tự động hóa windows",
+    "mở ứng dụng",
+    "chụp màn hình",
+    "computer use",
+    "windows-mcp",
+    "agent desktop",
+    "control my computer",
+    "automate windows"
+  ],
+  "requiredCapabilities": [],
+  "source": {
+    "repo": "leomieo (Limix AI)",
+    "license": "Proprietary (Limix AI)"
+  }
+}

package/skills/windows-computer-automation/references/herionix-integration.md

@@ -0,0 +1,72 @@
+# Hướng dẫn tích hợp vào Herionix (Windows 10/11)
+
+## 1. Chuẩn bị công cụ
+
+Cài Node.js/npm và Agent Desktop:
+
+```powershell
+npm install -g agent-desktop
+agent-desktop status
+```
+
+Cài `uv` và Python phiên bản phù hợp theo trang Windows-MCP (README hiện nêu Python 3.14+). Với Windows-MCP, dùng lệnh sau để kiểm tra server và lưu ý nó sẽ tiếp tục chạy cho đến khi client/terminal đóng:
+
+```powershell
+uvx windows-mcp serve --exclude-tools "PowerShell,Registry" --control-policy balanced
+```
+
+Tài liệu nguồn:
+- https://github.com/vercel-labs/agent-desktop
+- https://github.com/CursorTouch/Windows-MCP
+
+## 2. Đăng ký hai MCP Server vào backend
+
+Xem `assets/mcp-servers.example.json`. Đây là **MCP client config mẫu**, không phải định dạng config Herionix đã được xác nhận. Nếu Herionix dùng định dạng khác, chuyển hai `command` + `args` tương ứng vào cấu hình app. Chạy server trong phiên người dùng đang đăng nhập Windows và dùng stdio local.
+
+Backend phải hỗ trợ startup/healthcheck, khám phá `list_tools`, chuẩn hóa lỗi, timeout, shutdown; không spawn bản sao MCP server cho từng bot nếu chúng cùng điều khiển một session. Nếu máy có nhiều interactive sessions, phân biệt bằng `desktop_id` thực tế.
+
+## 3. Gắn Skill
+
+Đặt thư mục `windows-computer-automation` vào **skills directory mà Herionix thực sự tải**. Gắn Skill cho các Bot/Teammate được cho quyền computer-use. Nếu Herionix chưa có skill loader, cần thêm parser `SKILL.md` và entrypoints tương ứng — chỉ sao chép thư mục chưa biến thành kết nối MCP.
+
+## 4. Component đề xuất
+
+```text
+Bot / Teammate
+    |  task + intent
+    v
+ComputerControlManager (orchestrator)
+    |-- policy + host approvals
+    |-- desktop mutex + task queue
+    |-- state snapshots + idempotency
+    |-- progress watchdog + verification
+    +-- AgentDesktopAdapter ------> agent-desktop MCP
+    +-- WindowsMcpAdapter --------> windows-mcp MCP
+```
+
+Các module và trách nhiệm:
+- `ToolRegistry`: khám phá tên, schema và trạng thái tool của hai server.
+- `Planner/Router`: chọn provider theo tác vụ, không tự tạo lại tác dụng phụ khi chuyển provider.
+- `AuthorizationService`: người dùng cấp quyền, allowlist path, risk classification và token một lần.
+- `DesktopSessionScheduler`: khóa input per desktop/session và hàng đợi công bằng.
+- `ExecutionLedger`: task ID, step ID, state digest, trạng thái hoàn thành, idempotency.
+- `Verifier`: hậu điều kiện sau thao tác; phản hồi lỗi có phân loại để tránh vòng lặp.
+
+## 5. Cấu hình UI khuyến nghị
+
+Trong `Herionix > Tools > Windows Computer Automation`: bật/tắt cả hai providers; ưu tiên Agent Desktop cho UI; hiển thị số bot đang chờ quyền desktop; cho phép chọn thư mục ghi; quyền admin tools mặc định off; số lần retry tối đa 1; giới hạn 2 vòng không tiến triển; nút Stop/Emergency Release; audit log đã che dữ liệu nhạy cảm.
+
+## 6. Kiểm thử chấp nhận
+
+1. Bot A nhấn nút trong Notepad bằng ref; Bot B chờ, không can thiệp bàn phím.
+2. Ref UI hết hạn → snapshot mới; không dùng lại ref cũ và không spam retry.
+3. Bot liệt kê file đọc-only; ghi `.txt` trong thư mục cho phép và xác minh file.
+4. Xóa file / chạy PowerShell / Registry bị block hoặc yêu cầu host approval tương ứng.
+5. MCP Server tắt giữa tác vụ → dừng có trạng thái rõ, không tự lặp thao tác.
+6. Cùng một `step_id` gửi hai lần → tác dụng phụ chỉ thực thi tối đa một lần ở host.
+7. No progress hai chu kỳ → dừng và báo lý do, không clear context để lặp vô hạn.
+8. Không có desktop session/unlock → báo bị chặn, không giả thành công.
+
+## 7. Phạm vi bản đóng gói
+
+Skill này bao gồm quy trình, policy router có thể kiểm thử và cấu hình MCP mẫu. **Chưa phải bản cài đặt Herionix hoặc proxy MCP chạy sẵn**; thực thi connector, mutex liên tiến trình, duyệt quyền và xác minh file thật phải được hiện thực trong Herionix backend.