grok-bot-cli 0.8.0 → 0.9.0

package/dist/agent-bundle.package-compile-evidence.json

@@ -1 +1 @@
-{"assets":[{"externals":[{"externalType":"node-commonjs","issuers":["node_modules/yaml/dist/schema/yaml-1.1/binary.js"],"kind":"builtin","request":"buffer","userRequest":"buffer"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js","node_modules/agent-bundle/dist/install.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:child_process","userRequest":"node:child_process"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeCrypto.js","node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/667~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:crypto","userRequest":"node:crypto"},{"externalType":"node-commonjs","issuers":["node_modules/lru-cache/dist/commonjs/node/index.min.js"],"kind":"builtin","request":"node:diagnostics_channel","userRequest":"node:diagnostics_channel"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:events","userRequest":"node:events"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/install.js","node_modules/agent-bundle/dist/launch-env.js","node_modules/agent-bundle/dist/terminal-capability.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:fs","userRequest":"node:fs"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/667~1.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:fs/promises","userRequest":"node:fs/promises"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:net","userRequest":"node:net"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:os","userRequest":"node:os"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:os","userRequest":"node:os"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/@effect/platform-node-shared/dist/NodePath.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js","node_modules/agent-bundle/dist/launch-env.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:path","userRequest":"node:path"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:path","userRequest":"node:path"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:path/win32","userRequest":"node:path/win32"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:process","userRequest":"node:process"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeTerminal.js"],"kind":"builtin","request":"node:readline","userRequest":"node:readline"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js","node_modules/@effect/platform-node-shared/dist/NodeStream.js"],"kind":"builtin","request":"node:stream","userRequest":"node:stream"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/event-ipc.js"],"kind":"builtin","request":"node:string_decoder","userRequest":"node:string_decoder"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodePath.js","node_modules/agent-bundle/dist/install.js","src/gbot-install.ts"],"kind":"builtin","request":"node:url","userRequest":"node:url"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:url","userRequest":"node:url"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js","node_modules/commander/lib/help.js"],"kind":"builtin","request":"node:util","userRequest":"node:util"},{"externalType":"node-commonjs","issuers":["node_modules/yaml/dist/compose/composer.js","node_modules/yaml/dist/log.js","node_modules/yaml/dist/parse/parser.js"],"kind":"builtin","request":"process","userRequest":"process"}],"packages":["@effect/platform-node-shared","agent-bundle","ajv","ajv-formats","commander","effect","fast-deep-equal","fast-uri","hosted-git-info","json-schema-traverse","lru-cache","npm-package-arg","proc-log","semver","validate-npm-package-name","yaml"],"path":"bin/gbot-install.js","sha256":"9e220df3fbe33c6f13c2e96aa983ac96908b1d81c052932265ae88077b2e4fe0"}],"coverage":{"rewritable":false,"unobserved":["import(<expression>)","require(<expression>)","require.resolve(…)","createRequire(…)(…)","import.meta.resolve(…)"]},"policy":{"name":"closed-world-externals","revision":1},"producer":{"name":"agent-bundle","rspack":"2.2.4","version":"0.2.1"}}
+{"assets":[{"externals":[{"externalType":"node-commonjs","issuers":["node_modules/yaml/dist/schema/yaml-1.1/binary.js"],"kind":"builtin","request":"buffer","userRequest":"buffer"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js","node_modules/agent-bundle/dist/install.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:child_process","userRequest":"node:child_process"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeCrypto.js","node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/667~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:crypto","userRequest":"node:crypto"},{"externalType":"node-commonjs","issuers":["node_modules/lru-cache/dist/commonjs/node/index.min.js"],"kind":"builtin","request":"node:diagnostics_channel","userRequest":"node:diagnostics_channel"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:events","userRequest":"node:events"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/install.js","node_modules/agent-bundle/dist/launch-env.js","node_modules/agent-bundle/dist/terminal-capability.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:fs","userRequest":"node:fs"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/667~1.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:fs/promises","userRequest":"node:fs/promises"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:net","userRequest":"node:net"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/install.js"],"kind":"builtin","request":"node:os","userRequest":"node:os"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:os","userRequest":"node:os"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeFileSystem.js","node_modules/@effect/platform-node-shared/dist/NodePath.js","node_modules/agent-bundle/dist/738~1.js","node_modules/agent-bundle/dist/event-ipc.js","node_modules/agent-bundle/dist/install.js","node_modules/agent-bundle/dist/launch-env.js","node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:path","userRequest":"node:path"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:path","userRequest":"node:path"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:path/win32","userRequest":"node:path/win32"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js"],"kind":"builtin","request":"node:process","userRequest":"node:process"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeTerminal.js"],"kind":"builtin","request":"node:readline","userRequest":"node:readline"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodeChildProcessSpawner.js","node_modules/@effect/platform-node-shared/dist/NodeStream.js"],"kind":"builtin","request":"node:stream","userRequest":"node:stream"},{"externalType":"module","issuers":["node_modules/agent-bundle/dist/event-ipc.js"],"kind":"builtin","request":"node:string_decoder","userRequest":"node:string_decoder"},{"externalType":"module","issuers":["node_modules/@effect/platform-node-shared/dist/NodePath.js","node_modules/agent-bundle/dist/install.js","src/gbot-install.ts"],"kind":"builtin","request":"node:url","userRequest":"node:url"},{"externalType":"node-commonjs","issuers":["node_modules/npm-package-arg/lib/npa.js"],"kind":"builtin","request":"node:url","userRequest":"node:url"},{"externalType":"module","issuers":["node_modules/commander/lib/command.js","node_modules/commander/lib/help.js"],"kind":"builtin","request":"node:util","userRequest":"node:util"},{"externalType":"node-commonjs","issuers":["node_modules/yaml/dist/compose/composer.js","node_modules/yaml/dist/log.js","node_modules/yaml/dist/parse/parser.js"],"kind":"builtin","request":"process","userRequest":"process"}],"packages":["@effect/platform-node-shared","agent-bundle","ajv","ajv-formats","commander","effect","fast-deep-equal","fast-uri","hosted-git-info","json-schema-traverse","lru-cache","npm-package-arg","proc-log","semver","validate-npm-package-name","yaml"],"path":"bin/gbot-install.js","sha256":"df7d77ee0379c5c89aa9cb481a7de60f701d964bf259809d5f879e7270f41c12"}],"coverage":{"rewritable":false,"unobserved":["import(<expression>)","require(<expression>)","require.resolve(…)","createRequire(…)(…)","import.meta.resolve(…)"]},"policy":{"name":"closed-world-externals","revision":1},"producer":{"name":"agent-bundle","rspack":"2.2.4","version":"0.2.1"}}

package/dist/bin/gbot-flight.mjs

@@ -13474,6 +13474,14 @@ const agentSummarySchema = zod__rspack_import_3/* .object */.Ikc({
     notifyOnAgentUpdates: zod__rspack_import_3/* .boolean */.zMY().optional(),
     title: zod__rspack_import_3/* .string */.YjP().optional()
 }).strict();
+const skillSchema = zod__rspack_import_3/* .object */.Ikc({
+    description: zod__rspack_import_3/* .string */.YjP(),
+    id: zod__rspack_import_3/* .string */.YjP(),
+    name: zod__rspack_import_3/* .string */.YjP(),
+    pluginId: zod__rspack_import_3/* .string */.YjP().optional(),
+    source: zod__rspack_import_3/* .string */.YjP(),
+    sourceRef: zod__rspack_import_3/* .string */.YjP().optional()
+}).strict();
 const createFieldsSchema = zod__rspack_import_3/* .object */.Ikc({
     avatarColor: avatarColorSchema.optional(),
     avatarShape: avatarShapeSchema.optional(),
@@ -13516,6 +13524,7 @@ __webpack_require__.d(__webpack_exports__, {
 }, {
   FS: openBackendFromInput,
   R9: failureDocumentSchema,
+  b7: skillSchema,
   bY: createFieldsSchema,
   cp: toCreateInput,
   lK: backendFlagsSchema,
@@ -16102,6 +16111,202 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 
+},
+"./src/cli/skills/add.tsx"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+__webpack_require__.r(__webpack_exports__);
+/* import */ var react_jsx_runtime__rspack_import_0 = __webpack_require__("./node_modules/react/jsx-runtime.react-server.js");
+/* import */ var node_fs_promises__rspack_import_1 = __webpack_require__("node:fs/promises");
+/* import */ var node_path__rspack_import_2 = __webpack_require__("node:path");
+/* import */ var _agent_bundle_runtime__rspack_import_5 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/506.js");
+/* import */ var zod__rspack_import_4 = __webpack_require__("./node_modules/zod/v4/classic/schemas.js");
+/* import */ var _shared_js__rspack_import_3 = __webpack_require__("./src/cli/_shared.ts");
+
+
+
+
+
+
+const config = {
+    description: 'Add a SKILL.md to the shared skill library. Every bot sees it.',
+    inputJsonSchema: {
+        additionalProperties: false,
+        properties: {
+            dir: {
+                description: 'Agents directory for --files mode',
+                type: 'string'
+            },
+            files: {
+                description: 'Force the on-disk agents store',
+                type: 'boolean'
+            },
+            gateway: {
+                description: 'Force the live gateway',
+                type: 'boolean'
+            },
+            path: {
+                description: 'SKILL.md file, or a directory holding one',
+                type: 'string'
+            }
+        },
+        required: [
+            'path'
+        ],
+        type: 'object'
+    },
+    positionals: [
+        'path'
+    ]
+};
+const inputSchema = _shared_js__rspack_import_3/* .backendFlagsSchema.extend */.lK.extend({
+    path: zod__rspack_import_4/* .string */.YjP().min(1)
+}).strict();
+const resultSchema = _shared_js__rspack_import_3/* .skillSchema */.b7;
+const skillFile = async (path)=>{
+    const target = (0,node_path__rspack_import_2.resolve)(path);
+    return (await (0,node_fs_promises__rspack_import_1.stat)(target)).isDirectory() ? (0,node_path__rspack_import_2.join)(target, 'SKILL.md') : target;
+};
+async function skillsAdd({ input }) {
+    const markdown = await (0,node_fs_promises__rspack_import_1.readFile)(await skillFile(input.path), 'utf8');
+    const backend = await (0,_shared_js__rspack_import_3/* .openBackendFromInput */.FS)(input);
+    const skill = resultSchema.parse(await backend.addSkill(markdown));
+    return /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_5/* .Agent.Result */.g6.Result, {
+        value: skill,
+        children: /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_5/* .Agent.Text */.g6.Text, {
+            children: `Added skill ${skill.name} (${skill.id}) to the shared library`
+        })
+    });
+}
+
+__webpack_require__.d(__webpack_exports__, {
+  "default": () => (skillsAdd)
+}, {
+  config: config,
+  inputSchema: inputSchema,
+  resultSchema: resultSchema
+});
+
+
+},
+"./src/cli/skills/list.tsx"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+__webpack_require__.r(__webpack_exports__);
+/* import */ var react_jsx_runtime__rspack_import_0 = __webpack_require__("./node_modules/react/jsx-runtime.react-server.js");
+/* import */ var _agent_bundle_runtime__rspack_import_3 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/506.js");
+/* import */ var zod__rspack_import_2 = __webpack_require__("./node_modules/zod/v4/classic/schemas.js");
+/* import */ var _shared_js__rspack_import_1 = __webpack_require__("./src/cli/_shared.ts");
+
+
+
+
+const config = {
+    description: 'List the skill library every bot in this Grok Bot shares.',
+    inputJsonSchema: {
+        additionalProperties: false,
+        properties: {
+            dir: {
+                description: 'Agents directory for --files mode',
+                type: 'string'
+            },
+            files: {
+                description: 'Force the on-disk agents store',
+                type: 'boolean'
+            },
+            gateway: {
+                description: 'Force the live gateway',
+                type: 'boolean'
+            }
+        },
+        type: 'object'
+    }
+};
+const inputSchema = _shared_js__rspack_import_1/* .backendFlagsSchema */.lK;
+const resultSchema = zod__rspack_import_2/* .array */.YOg(_shared_js__rspack_import_1/* .skillSchema */.b7);
+async function skillsList({ input }) {
+    const backend = await (0,_shared_js__rspack_import_1/* .openBackendFromInput */.FS)(input);
+    const skills = resultSchema.parse(await backend.skills());
+    const lines = skills.map((s)=>`${s.id}  ${s.name}  [${s.source}]${s.description ? `  ${s.description}` : ''}`);
+    return /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_3/* .Agent.Result */.g6.Result, {
+        value: skills,
+        children: /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_3/* .Agent.Text */.g6.Text, {
+            children: lines.length > 0 ? lines.join('\n') : 'No skills.'
+        })
+    });
+}
+
+__webpack_require__.d(__webpack_exports__, {
+  "default": () => (skillsList)
+}, {
+  config: config,
+  inputSchema: inputSchema,
+  resultSchema: resultSchema
+});
+
+
+},
+"./src/cli/skills/remove.tsx"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+__webpack_require__.r(__webpack_exports__);
+/* import */ var react_jsx_runtime__rspack_import_0 = __webpack_require__("./node_modules/react/jsx-runtime.react-server.js");
+/* import */ var _agent_bundle_runtime__rspack_import_3 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/506.js");
+/* import */ var zod__rspack_import_2 = __webpack_require__("./node_modules/zod/v4/classic/schemas.js");
+/* import */ var _shared_js__rspack_import_1 = __webpack_require__("./src/cli/_shared.ts");
+
+
+
+
+const config = {
+    description: 'Remove a library skill by id or name. Every bot loses it.',
+    inputJsonSchema: {
+        additionalProperties: false,
+        properties: {
+            dir: {
+                description: 'Agents directory for --files mode',
+                type: 'string'
+            },
+            files: {
+                description: 'Force the on-disk agents store',
+                type: 'boolean'
+            },
+            gateway: {
+                description: 'Force the live gateway',
+                type: 'boolean'
+            },
+            skill: {
+                description: 'Skill id or name',
+                type: 'string'
+            }
+        },
+        required: [
+            'skill'
+        ],
+        type: 'object'
+    },
+    positionals: [
+        'skill'
+    ]
+};
+const inputSchema = _shared_js__rspack_import_1/* .backendFlagsSchema.extend */.lK.extend({
+    skill: zod__rspack_import_2/* .string */.YjP().min(1)
+}).strict();
+const resultSchema = _shared_js__rspack_import_1/* .skillSchema */.b7;
+async function skillsRemove({ input }) {
+    const backend = await (0,_shared_js__rspack_import_1/* .openBackendFromInput */.FS)(input);
+    const skill = resultSchema.parse(await backend.removeSkill(input.skill));
+    return /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_3/* .Agent.Result */.g6.Result, {
+        value: skill,
+        children: /*#__PURE__*/ (0,react_jsx_runtime__rspack_import_0.jsx)(_agent_bundle_runtime__rspack_import_3/* .Agent.Text */.g6.Text, {
+            children: `Removed skill ${skill.name} (${skill.id}) from the shared library`
+        })
+    });
+}
+
+__webpack_require__.d(__webpack_exports__, {
+  "default": () => (skillsRemove)
+}, {
+  config: config,
+  inputSchema: inputSchema,
+  resultSchema: resultSchema
+});
+
+
 },
 "./src/cli/thread.tsx"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
@@ -29778,7 +29983,10 @@ async function openBackend(opts) {
             removeGroupMember: (group, bot)=>_gateway_js__rspack_import_1/* .removeGroupMember */.A0(session, group, bot),
             send: (ref, prompt, extra)=>_gateway_js__rspack_import_1/* .sendPrompt */.LV(session, ref, prompt, extra),
             transcript: (ref, limit)=>_gateway_js__rspack_import_1/* .getTranscriptTail */.bA(session, ref, limit),
-            thread: (ref, rootId)=>_gateway_js__rspack_import_1/* .getThread */.fG(session, ref, rootId)
+            thread: (ref, rootId)=>_gateway_js__rspack_import_1/* .getThread */.fG(session, ref, rootId),
+            skills: ()=>_gateway_js__rspack_import_1/* .listSkills */.bG(session),
+            addSkill: (markdown)=>_gateway_js__rspack_import_1/* .addSkill */.L5(session, markdown),
+            removeSkill: (skillRef)=>_gateway_js__rspack_import_1/* .removeSkill */.uX(session, skillRef)
         };
     }
     const root = _store_js__rspack_import_0/* .resolveAgentsRoot */.v1(opts.root);
@@ -29802,6 +30010,15 @@ async function openBackend(opts) {
         },
         thread: async ()=>{
             throw new _store_js__rspack_import_0/* .StoreError */.AD("thread requires the live gateway");
+        },
+        skills: async ()=>{
+            throw new _store_js__rspack_import_0/* .StoreError */.AD("skills requires the live gateway");
+        },
+        addSkill: async ()=>{
+            throw new _store_js__rspack_import_0/* .StoreError */.AD("skills requires the live gateway");
+        },
+        removeSkill: async ()=>{
+            throw new _store_js__rspack_import_0/* .StoreError */.AD("skills requires the live gateway");
         }
     };
 }
@@ -30812,6 +31029,88 @@ async function deleteAgent(session, ref) {
     });
     return rec;
 }
+// Grok Bot keeps one skill library per box. Every bot reads the same list, and the
+// workflow RPCs take any bot id only to say whose automations ride along.
+const SKILL_MAX_BODY_LENGTH = 100000;
+const SKILL_SOURCES = {
+    workflow: "your library",
+    managed: "team-managed",
+    plugin: "a plugin",
+    automation: "a scheduled automation"
+};
+function asSkill(skill) {
+    return {
+        id: String(skill.id),
+        name: skill.name || "",
+        description: skill.description || "",
+        source: String(skill.source || "workflow"),
+        ...skill.sourceRef ? {
+            sourceRef: String(skill.sourceRef)
+        } : {},
+        ...skill.pluginId ? {
+            pluginId: String(skill.pluginId)
+        } : {}
+    };
+}
+function asSkills(data) {
+    const list = Array.isArray(data) ? data : Array.isArray(data?.workflows) ? data.workflows : [];
+    return list.filter((s)=>s && s.id).map(asSkill);
+}
+async function anyBotId(session) {
+    const bot = (await listAgents(session)).find((r)=>!r.isGroup);
+    if (!bot) throw new GatewayError("Skills need at least one bot. Run gbot bots create first.");
+    return bot.id;
+}
+async function listSkills(session) {
+    return asSkills(await gatewayCall(session, "getAgentWorkflows", {
+        id: await anyBotId(session)
+    }));
+}
+async function addSkill(session, markdown) {
+    const text = String(markdown);
+    if (!text.trim()) throw new GatewayError("Skill markdown is empty.");
+    if (text.length > SKILL_MAX_BODY_LENGTH) {
+        throw new GatewayError(`Skill markdown is ${text.length} characters. Grok Bot truncates bodies over ${SKILL_MAX_BODY_LENGTH}; shorten it.`);
+    }
+    const id = await anyBotId(session);
+    let data;
+    try {
+        data = await gatewayCall(session, "importAgentWorkflowText", {
+            id,
+            markdown: text
+        });
+    } catch (error) {
+        if (error instanceof GatewayError && /response too large/.test(error.message)) {
+            throw new GatewayError("Grok Bot echoed a skill list too large to read; the import may still have landed. Run gbot skills list.");
+        }
+        throw error;
+    }
+    const imported = data.result?.imported?.[0];
+    if (!imported) {
+        const reason = data.result?.skipped?.[0]?.reason || "rejected";
+        throw new GatewayError(`Grok Bot did not import the skill (${reason}). It needs a name, a non-empty body, and library room.`);
+    }
+    return asSkills(data).find((s)=>s.id === String(imported.id)) ?? asSkill(imported);
+}
+async function removeSkill(session, skillRef) {
+    const id = await anyBotId(session);
+    const skills = asSkills(await gatewayCall(session, "getAgentWorkflows", {
+        id
+    }));
+    const needle = String(skillRef).trim().toLowerCase();
+    const matches = skills.filter((s)=>s.id.toLowerCase() === needle || s.name.toLowerCase() === needle);
+    if (matches.length === 0) throw new GatewayError(`No skill "${skillRef}".`);
+    if (matches.length > 1) throw new GatewayError(`Ambiguous skill name "${skillRef}". Use the id.`);
+    if (matches[0].source !== "workflow") {
+        const kind = SKILL_SOURCES[matches[0].source] || matches[0].source;
+        throw new GatewayError(`"${matches[0].name}" is ${kind}, not a library skill. Manage it where it came from.`);
+    }
+    await gatewayCall(session, "deleteAgentWorkflow", {
+        id,
+        workflowId: matches[0].id
+    });
+    return matches[0];
+}
 function normalizeMemberIds(records, memberRefs) {
     const memberIds = new Set();
     for (const ref of memberRefs){
@@ -30986,6 +31285,7 @@ async function respondGrokApproval(session, ref, input) {
 
 __webpack_require__.d(__webpack_exports__, {
   A0: () => (removeGroupMember),
+  L5: () => (addSkill),
   LV: () => (sendPrompt),
   MI: () => (listGrokApprovals),
   OR: () => (respondGrokApproval),
@@ -30994,9 +31294,11 @@ __webpack_require__.d(__webpack_exports__, {
   Td: () => (setGroupMembers),
   Vq: () => (connectGateway),
   bA: () => (getTranscriptTail),
+  bG: () => (listSkills),
   fG: () => (getThread),
   nF: () => (hasGatewayAuth),
   qE: () => (resolveRef),
+  uX: () => (removeSkill),
   vc: () => (listAgents),
   wj: () => (createGroup),
   x4: () => (updateAgent),
@@ -32083,7 +32385,7 @@ __webpack_require__.d(__webpack_exports__, {
 
 },
 "./package.json"(module) {
-module.exports = {"rE":"0.8.0"}
+module.exports = {"rE":"0.9.0"}
 
 },
 
@@ -32149,9 +32451,9 @@ __webpack_require__.r = (exports) => {
 var __webpack_exports__ = {};
 /* import */ var node_worker_threads__rspack_import_0 = __webpack_require__("node:worker_threads");
 /* import */ var react__rspack_import_1 = __webpack_require__("./node_modules/react/react.react-server.js");
-/* import */ var _agent_bundle_runtime_flight_server__rspack_import_37 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/flight/server.js");
-/* import */ var _agent_bundle_runtime__rspack_import_35 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/49.js");
-/* import */ var _agent_bundle_runtime__rspack_import_36 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/736.js");
+/* import */ var _agent_bundle_runtime_flight_server__rspack_import_40 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/flight/server.js");
+/* import */ var _agent_bundle_runtime__rspack_import_38 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/49.js");
+/* import */ var _agent_bundle_runtime__rspack_import_39 = __webpack_require__("./node_modules/@agent-bundle/runtime/dist/736.js");
 /* import */ var node_url__rspack_import_2 = __webpack_require__("node:url");
 /* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_approvals_list_tsx__rspack_import_3 = __webpack_require__("./src/cli/approvals/list.tsx");
 /* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_approvals_respond_tsx__rspack_import_4 = __webpack_require__("./src/cli/approvals/respond.tsx");
@@ -32184,7 +32486,10 @@ var __webpack_exports__ = {};
 /* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_groups_update_tsx__rspack_import_31 = __webpack_require__("./src/cli/groups/update.tsx");
 /* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_history_tsx__rspack_import_32 = __webpack_require__("./src/cli/history.tsx");
 /* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_send_tsx__rspack_import_33 = __webpack_require__("./src/cli/send.tsx");
-/* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_34 = __webpack_require__("./src/cli/thread.tsx");
+/* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_add_tsx__rspack_import_34 = __webpack_require__("./src/cli/skills/add.tsx");
+/* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_list_tsx__rspack_import_35 = __webpack_require__("./src/cli/skills/list.tsx");
+/* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_remove_tsx__rspack_import_36 = __webpack_require__("./src/cli/skills/remove.tsx");
+/* import */ var _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_37 = __webpack_require__("./src/cli/thread.tsx");
 
 
 
@@ -32253,8 +32558,14 @@ const route29 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_gro
 
 const route30 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_send_tsx__rspack_import_33, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_send_tsx__rspack_import_33);
 
-const route31 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_34, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_34);
-const pluginRoot = (0,_agent_bundle_runtime__rspack_import_35/* .resolvePluginRoot */.E7)({
+const route31 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_add_tsx__rspack_import_34, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_add_tsx__rspack_import_34);
+
+const route32 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_list_tsx__rspack_import_35, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_list_tsx__rspack_import_35);
+
+const route33 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_remove_tsx__rspack_import_36, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_skills_remove_tsx__rspack_import_36);
+
+const route34 = Object.assign({}, Reflect.get(_home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_37, 'default'), _home_runner_work_grok_bot_cli_grok_bot_cli_src_cli_thread_tsx__rspack_import_37);
+const pluginRoot = (0,_agent_bundle_runtime__rspack_import_38/* .resolvePluginRoot */.E7)({
     fallback: (0,node_url__rspack_import_2.fileURLToPath)(new URL('..', import.meta.url)),
     stateAnchor: 'user-data'
 });
@@ -32458,11 +32769,29 @@ const routes = Object.freeze({
         name: "send",
         module: route30
     }),
+    "cli:skills/add": Object.freeze({
+        id: "cli:skills/add",
+        kind: "cli",
+        name: "skills add",
+        module: route31
+    }),
+    "cli:skills/list": Object.freeze({
+        id: "cli:skills/list",
+        kind: "cli",
+        name: "skills list",
+        module: route32
+    }),
+    "cli:skills/remove": Object.freeze({
+        id: "cli:skills/remove",
+        kind: "cli",
+        name: "skills remove",
+        module: route33
+    }),
     "cli:thread": Object.freeze({
         id: "cli:thread",
         kind: "cli",
         name: "thread",
-        module: route31
+        module: route34
     })
 });
 const requests = new Map();
@@ -32497,18 +32826,18 @@ const render = async (message)=>{
     };
     try {
         const cwd = process.cwd();
-        await (0,_agent_bundle_runtime__rspack_import_36/* .runAgentRequest */.iC)({
+        await (0,_agent_bundle_runtime__rspack_import_39/* .runAgentRequest */.iC)({
             capabilities: {
-                command: (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)(),
-                filesystem: (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)(),
-                network: (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)(),
-                projectRoot: (0,_agent_bundle_runtime__rspack_import_36/* .available */.qC)({
+                command: (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)(),
+                filesystem: (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)(),
+                network: (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)(),
+                projectRoot: (0,_agent_bundle_runtime__rspack_import_39/* .available */.qC)({
                     root: cwd
                 }, 'derived')
             },
-            host: (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)('unsupported-surface'),
+            host: (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)('unsupported-surface'),
             invocation: message.request,
-            lineage: (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)('unsupported-surface'),
+            lineage: (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)('unsupported-surface'),
             plugin: pluginRoot.identity,
             progress: {
                 report: async (update)=>{
@@ -32521,8 +32850,8 @@ const render = async (message)=>{
             },
             process: processHit,
             signal: controller.signal,
-            terminal: message.terminal === undefined ? (0,_agent_bundle_runtime__rspack_import_36/* .unavailable */.hU)('not-provided') : (0,_agent_bundle_runtime__rspack_import_36/* .available */.qC)(message.terminal, 'native'),
-            workspace: (0,_agent_bundle_runtime__rspack_import_36/* .available */.qC)({
+            terminal: message.terminal === undefined ? (0,_agent_bundle_runtime__rspack_import_39/* .unavailable */.hU)('not-provided') : (0,_agent_bundle_runtime__rspack_import_39/* .available */.qC)(message.terminal, 'native'),
+            workspace: (0,_agent_bundle_runtime__rspack_import_39/* .available */.qC)({
                 root: cwd
             }, 'derived')
         }, async ()=>{
@@ -32531,7 +32860,7 @@ const render = async (message)=>{
                 type: 'observed-render-start'
             });
             const renderStartedAt = performance.now();
-            const flight = (0,_agent_bundle_runtime_flight_server__rspack_import_37/* .renderAgentFlight */.y)(composeLayouts(observedRoute, {
+            const flight = (0,_agent_bundle_runtime_flight_server__rspack_import_40/* .renderAgentFlight */.y)(composeLayouts(observedRoute, {
                 ...message.props,
                 signal: controller.signal
             }, controller.signal), {

package/dist/bin/gbot-install.js

@@ -39391,8 +39391,13 @@ const installPublicCli = async (options, identity, host, scope)=>{
             previousContentHash = installed?.hash ?? previousReceipt?.contentHash;
         }
     }
+    if (replaced && 'codex' === host && entry?.enabled !== true) {
+        const reason = entry?.enabled === false ? 'plugin list reports enabled: false' : 'plugin list omits enabled';
+        throw identity_failure('AB7004', `Cannot replace the Codex install of ${id}: ${reason}. The native plugin CLI has no qualified settings-preserving update API, and native \`plugin add\` resets plugin-level enabled to true. Enable the plugin in Codex before replacing, or leave this install unchanged.`, host);
+    }
     const recorded = await receiptIdentity();
-    if (replaced) await runHostCommand(runner, identity, host, publicHostUninstallArguments(host, id, scope), 'removal');
+    const replaceRemovesPlugin = replaced && 'codex' !== host;
+    if (replaceRemovesPlugin) await runHostCommand(runner, identity, host, publicHostUninstallArguments(host, id, scope), 'removal');
     await runHostCommand(runner, identity, host, [
         'plugin',
         'marketplace',
@@ -39438,7 +39443,7 @@ const installPublicCli = async (options, identity, host, scope)=>{
     } catch (error) {
         if (void 0 !== stateRollback) await stateRollback();
         const rollbacks = [
-            ...pluginInstalled ? [
+            ...pluginInstalled && !('codex' === host && replaced) ? [
                 publicHostUninstallArguments(host, id, scope)
             ] : [],
             ...createdMarketplace ? [
@@ -41647,7 +41652,7 @@ const doctor_readPublicHostInventory = (host, identity, listing, environment, ho
         marketplace: identity.marketplace ?? '',
         plugin: identity.plugin
     });
-const publicHostReplaceRecipe = (host, scopeArguments = '')=>'claude' === host ? `Rerun \`agent-bundle install claude --from <bundle-dir>${scopeArguments}\`; same-version content drift is replaced through \`claude plugin uninstall --keep-data\` + \`claude plugin install\` because Claude\'s \`plugin update\` is version-gated.` : "Rerun `agent-bundle install codex --from <bundle-dir>`; same-version content drift is replaced through `codex plugin remove` + `codex plugin add`.";
+const publicHostReplaceRecipe = (host, scopeArguments = '')=>'claude' === host ? `Rerun \`agent-bundle install claude --from <bundle-dir>${scopeArguments}\`; same-version content drift is replaced through \`claude plugin uninstall --keep-data\` + \`claude plugin install\` because Claude\'s \`plugin update\` is version-gated.` : "Rerun `agent-bundle install codex --from <bundle-dir>`; same-version content drift is replaced through `codex plugin add` so plugin settings and nested MCP overrides in config.toml survive. Replacement is refused (`AB7004`) when plugin list reports `enabled: false` or omits `enabled`, because the native plugin CLI has no qualified settings-preserving update API.";
 const hostLoadFailureDiagnostic = (host, copy, errors, replaceHint = '')=>doctor_diagnostic('AB7325', `${host} refused to load ${copy}: ${errors.join(' | ')}`, `Fix the artifact so \`${host} plugin list --json\` reports no \`errors\` for it, rebuild, and rerun \`agent-bundle install ${host} --from <bundle-dir>${replaceHint} --replace\`.`, 'error', host);
 const disabledInstallDiagnostic = (identity, version, installPath, scope)=>doctor_diagnostic('AB7327', `claude lists ${identity.plugin}@${version} at ${installPath}${void 0 === scope ? '' : ` (scope ${scope})`} as disabled (\`enabled: false\`): the copy is installed but none of it loads in a session.`, `Run \`claude plugin enable ${identity.plugin}${void 0 === identity.marketplace ? '' : `@${identity.marketplace}`}${void 0 === scope ? '' : ` --scope ${scope}`}\` (or \`/plugin\` in a session), then rerun Doctor; reinstalling does not enable a disabled plugin.`, 'warning', 'claude');
 const publicHostInstallComparison = async (host, identity, artifact, inventory)=>{