@sema-agent/cli 1.0.42 → 1.0.44

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@sema-agent/cli",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@sema-agent/cli",
-      "version": "1.0.42",
+      "version": "1.0.44",
       "license": "BUSL-1.1",
       "dependencies": {
         "@sema-agent/sdk": "0.0.63",
@@ -629,9 +629,9 @@
       }
     },
     "node_modules/@sema-agent/core": {
-      "version": "1.361.0",
-      "resolved": "https://registry.npmjs.org/@sema-agent/core/-/core-1.361.0.tgz",
-      "integrity": "sha512-Avbmu1VfaWuLFM7kv0Y4TDv3MDoIPeqrBaztgX9F7XyUBwYyV8axfhn9M6Xly6NYH692SXJM9PlwVxTPUp5+bA==",
+      "version": "1.362.0",
+      "resolved": "https://registry.npmjs.org/@sema-agent/core/-/core-1.362.0.tgz",
+      "integrity": "sha512-pfr7dIhKdsw7T8WT4QsCYebXbZtcL9ALjCwalSFpjsTYl3Qhlk0walUrB03rwQBGP9TW4COL7mX9tRgM3KYXwA==",
       "license": "BUSL-1.1",
       "dependencies": {
         "@modelcontextprotocol/sdk": "1.29.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/cli",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "description": "Sema — your own Claude Code-grade coding agent, in the terminal.",
   "license": "BUSL-1.1",
   "bin": {
@@ -25,10 +25,10 @@
     "@sema-agent/server": "1.242.0"
   },
   "overrides": {
-    "@sema-agent/core": "1.361.0",
+    "@sema-agent/core": "1.362.0",
     "@sema-agent/registry-core": "0.10.21"
   },
-  "semaEngineVersion": "server 1.242.0 / core 1.361.0 / registry-core 0.10.21",
+  "semaEngineVersion": "server 1.242.0 / core 1.362.0 / registry-core 0.10.21",
   "engines": {
     "node": ">=18"
   }

package/sema.js

@@ -208481,9 +208481,13 @@ function getSemaGuideBasePrompt() {
   const localSearchHint = hasEmbeddedSearchTools() ? `${FILE_READ_TOOL_NAME}, \`find\`, and \`grep\`` : `${FILE_READ_TOOL_NAME}, ${GLOB_TOOL_NAME}, and ${GREP_TOOL_NAME}`;
   return `You are the sema guide agent. Your primary responsibility is helping users understand and use sema (the CLI tool) effectively.
 
+**Product identity (ground truth \u2014 never contradict this):**
+
+sema is an AI coding CLI that is fully Sema-compatible and a superset of it. The Sema ecosystem works unchanged: CLAUDE.md project memory, .claude/ project config, plugin marketplaces (/plugin), skills (/skills), MCP servers, hooks, and custom subagents. When external docs or tutorials reference the \`claude\` command, the sema equivalent is the same command with \`sema\` substituted (e.g. \`sema mcp add X\` \u2192 \`sema mcp add X\`). Beyond Sema, sema adds: a local engine process the TUI drives, model freedom via the Model Hub (/model in-session or \`sema model\` \u2014 any provider, roles/tiers configurable), cloud switching (\`sema cloud\` for cloud registry profiles and sign-in; service/store/exec axes each local or cloud), \`sema config\`, guided \`sema onboard\`, Sema data import (\`sema import\`), background sessions (\`sema ps\`/\`sema logs\`/\`sema attach\`/\`sema kill\`), and diagnostics (\`sema doctor\`, /doctor).
+
 **Your expertise:**
 
-sema (the CLI tool): installation, configuration, settings files (~/.sema/settings.json and project .sema/), hooks, custom skills and slash commands, MCP server configuration, custom subagents (.sema/agents/), model and tier-group configuration, workflows, keyboard shortcuts, and everyday usage.
+sema (the CLI tool): installation, configuration, settings files (~/.sema/settings.json and project .sema/), hooks, custom skills and slash commands, MCP server configuration, custom subagents (.sema/agents/), model and tier-group configuration, cloud registry profiles, workflows, keyboard shortcuts, and everyday usage.
 
 **Approach:**
 1. Prefer the user's LOCAL ground truth: the project's memory/config files (CLAUDE.md, the .sema/ directory), the user's ~/.sema settings, and the configuration surfaced to you below.
@@ -244614,13 +244618,17 @@ __export(engineSideChannel_exports, {
 });
 import { readFileSync as readFileSync23 } from "node:fs";
 import { join as join73 } from "node:path";
-async function sideQueryCapable(client4, baseUrl, signal) {
+async function sideQueryCapable(client4, baseUrl, budget, signal) {
   const hit = sideQueryCapByBase.get(baseUrl);
-  if (hit !== void 0) return hit;
+  if (hit && (hit.ok || Date.now() - hit.at < CAP_FALSE_RETRY_TTL_MS)) return hit.ok;
   try {
-    const caps = await withTimeoutSignal(CAPS_PROBE_TIMEOUT_MS, signal, (s) => client4.capabilities({ signal: s }));
+    const caps = await withTimeoutSignal(
+      Math.min(CAPS_PROBE_TIMEOUT_MS, budget.remaining()),
+      signal,
+      (s) => client4.capabilities({ signal: s })
+    );
     const ok2 = caps.sideQuery === true;
-    sideQueryCapByBase.set(baseUrl, ok2);
+    sideQueryCapByBase.set(baseUrl, { ok: ok2, at: Date.now() });
     return ok2;
   } catch {
     return false;
@@ -244686,7 +244694,11 @@ async function resolvePoolModelRef(callerModel) {
     return void 0;
   }
 }
-async function engineUtilityText(opts) {
+function makeBudget(totalMs) {
+  const start = Date.now();
+  return { remaining: () => Math.max(1, totalMs - (Date.now() - start)) };
+}
+async function engineUtilityCall(opts) {
   const baseUrl = process.env.SEMA_LIVE_BASEURL;
   if (!baseUrl) return null;
   const token = resolveEngineToken();
@@ -244696,117 +244708,90 @@ async function engineUtilityText(opts) {
     principal: process.env.SEMA_LIVE_PRINCIPAL ?? "anon:shell-live"
   });
   if (!client4) throw new Error("sema engine side-channel: wire client unavailable");
-  const cheap = process.env.MODEL_CHEAP_ID?.trim() || void 0;
-  const timeoutMs = opts.timeoutMs ?? SIDE_CHANNEL_TIMEOUT_MS;
+  const cheap = opts.cheapSlot ? process.env.MODEL_CHEAP_ID?.trim() || void 0 : void 0;
+  const budget = makeBudget(opts.timeoutMs ?? SIDE_CHANNEL_TIMEOUT_MS);
+  const firstModel = opts.modelRef ?? cheap;
   const statusOf2 = (e) => {
     const s = e?.status;
     return typeof s === "number" ? s : void 0;
   };
-  const firstModel = opts.modelRef ?? cheap;
-  if (await sideQueryCapable(client4, baseUrl, opts.signal)) {
-    const query2 = (model) => withTimeoutSignal(
-      timeoutMs,
+  const tasksArm = async () => {
+    const submit = (model) => withTimeoutSignal(
+      budget.remaining(),
       opts.signal,
-      (signal) => client4.sideQuery.query(
+      (signal) => client4.tasks.submit(
         {
-          messages: [{ role: "user", content: opts.objective }],
+          objective: opts.objective,
+          sessionId: mintSideSessionId(),
+          // 独立 session:utility 提示词绝不进主会话历史
           ...model ? { model } : {},
-          ...opts.maxTokens ? { maxOutputTokens: opts.maxTokens } : {}
+          ...opts.maxTokens ? { maxTokens: opts.maxTokens } : {},
+          ...opts.systemPrompt ? { systemPrompt: opts.systemPrompt } : {},
+          ...opts.excludeTools ? { excludeTools: [...opts.excludeTools] } : {}
         },
-        { signal }
+        { signal, idempotencyKey: null }
       )
     );
-    let r;
+    let data;
     try {
-      r = await query2(firstModel);
+      data = await submit(firstModel);
     } catch (e) {
       const status3 = statusOf2(e);
       if (opts.noFallback || status3 === void 0 || !firstModel || !CATALOG_GATE_STATUSES.has(status3)) throw e;
-      logForDebugging(`[side-channel] side-query ${status3} with model=${firstModel} \u2014 retrying on the default model`);
-      r = await query2(void 0);
-    }
-    return sideQueryTextOf(r);
-  }
-  const submit = (model) => withTimeoutSignal(
-    timeoutMs,
-    opts.signal,
-    (signal) => client4.tasks.submit(
-      {
-        objective: opts.objective,
-        sessionId: mintSideSessionId(),
-        // 独立 session:utility 提示词绝不进主会话历史
-        ...model ? { model } : {},
-        ...opts.maxTokens ? { maxTokens: opts.maxTokens } : {}
-      },
-      { signal, idempotencyKey: null }
-    )
-  );
-  let data;
-  try {
-    data = await submit(firstModel);
-  } catch (e) {
-    const status3 = statusOf2(e);
-    if (opts.noFallback || status3 === void 0 || !firstModel || !CATALOG_GATE_STATUSES.has(status3)) throw e;
-    logForDebugging(`[side-channel] engine ${status3} with model=${firstModel} \u2014 retrying on the default model`);
-    data = await submit(void 0);
-  }
-  const text2 = typeof data.result === "string" ? data.result.trim() : "";
-  if (!text2) throw new Error("sema engine side-channel: empty result");
-  return text2;
-}
-async function engineUtilityTask(opts) {
-  const baseUrl = process.env.SEMA_LIVE_BASEURL;
-  if (!baseUrl) throw new Error("sema engine side-channel: not active");
-  const token = resolveEngineToken();
-  const client4 = makeEngineWireClient({
-    baseUrl,
-    ...token ? { token } : {},
-    principal: process.env.SEMA_LIVE_PRINCIPAL ?? "anon:shell-live"
-  });
-  if (!client4) throw new Error("sema engine side-channel: wire client unavailable");
-  const timeoutMs = opts.timeoutMs ?? SIDE_CHANNEL_TIMEOUT_MS;
-  if (await sideQueryCapable(client4, baseUrl, opts.signal)) {
-    const r = await withTimeoutSignal(
-      timeoutMs,
+      logForDebugging(`[side-channel] engine ${status3} with model=${firstModel} \u2014 retrying on the default model`);
+      data = await submit(void 0);
+    }
+    const text2 = typeof data.result === "string" ? data.result.trim() : "";
+    if (!text2) throw new Error("sema engine side-channel: empty result");
+    const st2 = data.stats;
+    const usage = st2 ? {
+      input_tokens: st2.promptTokens ?? st2.totalInputTokens ?? 0,
+      output_tokens: st2.outputTokens ?? 0,
+      cache_creation_input_tokens: st2.cacheWriteTokens ?? 0,
+      cache_read_input_tokens: st2.cachedTokens ?? 0
+    } : null;
+    return { text: text2, usage };
+  };
+  if (await sideQueryCapable(client4, baseUrl, budget, opts.signal)) {
+    const query2 = (model) => withTimeoutSignal(
+      budget.remaining(),
       opts.signal,
       (signal) => client4.sideQuery.query(
         {
           messages: [{ role: "user", content: opts.objective }],
-          ...opts.modelRef ? { model: opts.modelRef } : {},
+          ...model ? { model } : {},
           ...opts.maxTokens ? { maxOutputTokens: opts.maxTokens } : {},
           ...opts.systemPrompt ? { systemPrompt: opts.systemPrompt } : {}
         },
         { signal }
       )
     );
+    let r;
+    try {
+      r = await query2(firstModel);
+    } catch (e) {
+      const status3 = statusOf2(e);
+      if (status3 !== void 0 && ENDPOINT_GONE_STATUSES.has(status3)) {
+        sideQueryCapByBase.set(baseUrl, { ok: false, at: Date.now() });
+        logForDebugging(`[side-channel] side-query endpoint gone (${status3}) \u2014 falling back to tasks`);
+        return await tasksArm();
+      }
+      if (opts.noFallback || status3 === void 0 || !firstModel || !SIDEQUERY_MODEL_GATE_STATUSES.has(status3)) throw e;
+      logForDebugging(`[side-channel] side-query ${status3} with model=${firstModel} \u2014 retrying on the default model`);
+      r = await query2(void 0);
+    }
     return { text: sideQueryTextOf(r), usage: usageFromSideQuery(r) };
   }
-  const data = await withTimeoutSignal(
-    timeoutMs,
-    opts.signal,
-    (signal) => client4.tasks.submit(
-      {
-        objective: opts.objective,
-        sessionId: mintSideSessionId(),
-        // 独立 session:utility 提示词绝不进主会话历史
-        ...opts.modelRef ? { model: opts.modelRef } : {},
-        ...opts.maxTokens ? { maxTokens: opts.maxTokens } : {},
-        ...opts.systemPrompt ? { systemPrompt: opts.systemPrompt } : {},
-        ...opts.excludeTools ? { excludeTools: [...opts.excludeTools] } : {}
-      },
-      { signal, idempotencyKey: null }
-    )
-  );
-  const text2 = typeof data.result === "string" ? data.result.trim() : "";
-  if (!text2) throw new Error("sema engine side-channel: empty result");
-  const st2 = data.stats;
-  const usage = st2 ? {
-    input_tokens: st2.promptTokens ?? st2.totalInputTokens ?? 0,
-    output_tokens: st2.outputTokens ?? 0,
-    cache_creation_input_tokens: st2.cacheWriteTokens ?? 0,
-    cache_read_input_tokens: st2.cachedTokens ?? 0
-  } : null;
-  return { text: text2, usage };
+  return await tasksArm();
+}
+async function engineUtilityText(opts) {
+  const r = await engineUtilityCall({ ...opts, cheapSlot: true });
+  return r === null ? null : r.text;
+}
+async function engineUtilityTask(opts) {
+  const r = await engineUtilityCall(opts);
+  if (r === null) throw new Error("sema engine side-channel: not active");
+  return r;
 }
 function extractJsonObjectText(text2) {
   const m2 = text2.match(/\{[\s\S]*\}/);
@@ -244824,7 +244809,7 @@ function jsonDisciplineSuffix(schema) {
 Return ONLY a JSON object (no prose, no markdown code fences) that matches this JSON Schema:
 ${JSON.stringify(schema)}`;
 }
-var SIDE_CHANNEL_TIMEOUT_MS, sideQueryCapByBase, CAPS_PROBE_TIMEOUT_MS, CATALOG_GATE_STATUSES, UTILITY_EXCLUDE_ALL_TOOLS;
+var SIDE_CHANNEL_TIMEOUT_MS, sideQueryCapByBase, CAPS_PROBE_TIMEOUT_MS, CAP_FALSE_RETRY_TTL_MS, CATALOG_GATE_STATUSES, SIDEQUERY_MODEL_GATE_STATUSES, ENDPOINT_GONE_STATUSES, UTILITY_EXCLUDE_ALL_TOOLS;
 var init_engineSideChannel = __esm({
   "build-src/src/sema/engineSideChannel.ts"() {
     init_debug();
@@ -244833,7 +244818,10 @@ var init_engineSideChannel = __esm({
     SIDE_CHANNEL_TIMEOUT_MS = 6e4;
     sideQueryCapByBase = /* @__PURE__ */ new Map();
     CAPS_PROBE_TIMEOUT_MS = 5e3;
+    CAP_FALSE_RETRY_TTL_MS = 5 * 6e4;
     CATALOG_GATE_STATUSES = /* @__PURE__ */ new Set([400, 404, 422]);
+    SIDEQUERY_MODEL_GATE_STATUSES = /* @__PURE__ */ new Set([400, 422]);
+    ENDPOINT_GONE_STATUSES = /* @__PURE__ */ new Set([404, 405, 501]);
     UTILITY_EXCLUDE_ALL_TOOLS = [
       "Bash",
       "PowerShell",
@@ -272431,14 +272419,16 @@ async function semaSideQueryViaEngine(opts, side) {
   else if (opts.output_format?.schema) objective += side.jsonDisciplineSuffix(opts.output_format.schema);
   const isModelValidation = opts.querySource === "model_validation";
   const modelRef = await side.resolvePoolModelRef(opts.model) ?? (isModelValidation ? opts.model : void 0);
-  const text2 = await side.engineUtilityText({
+  const r = await side.engineUtilityTask({
     objective,
     signal: opts.signal,
     // validateModel 类 1-token ping 在任务语义下会空转 → 托底 16,verdict 仍由成功/失败承载
     maxTokens: Math.max(16, opts.max_tokens ?? 1024),
     modelRef,
-    noFallback: isModelValidation
-  }) ?? "";
+    noFallback: isModelValidation,
+    cheapSlot: true
+  });
+  const text2 = r.text;
   const stamp2 = Date.now().toString(36);
   let content;
   if (forcedTool) {
@@ -272465,7 +272455,8 @@ async function semaSideQueryViaEngine(opts, side) {
     content,
     stop_reason: "end_turn",
     stop_sequence: null,
-    usage: {
+    // 对抗复审批 #3:verb 臂权威 usage / tasks 臂 TaskStats 映射;引擎无账时诚实零
+    usage: r.usage ?? {
       input_tokens: 0,
       output_tokens: 0,
       cache_creation_input_tokens: 0,
@@ -440718,6 +440709,36 @@ var init_ScrollBox = __esm({
   }
 });
 
+// build-src/src/sema/selfKnowledge.ts
+var selfKnowledge_exports = {};
+__export(selfKnowledge_exports, {
+  SEMA_IDENTITY_LINE: () => SEMA_IDENTITY_LINE,
+  SEMA_SELF_KNOWLEDGE: () => SEMA_SELF_KNOWLEDGE,
+  withSelfKnowledgeOutputStyle: () => withSelfKnowledgeOutputStyle
+});
+function withSelfKnowledgeOutputStyle(existing) {
+  if (!existing || !existing.trim()) return SEMA_SELF_KNOWLEDGE;
+  if (existing.includes("# About sema (product context)")) return existing;
+  return `${SEMA_SELF_KNOWLEDGE}
+
+${existing}`;
+}
+var SEMA_SELF_KNOWLEDGE, SEMA_IDENTITY_LINE;
+var init_selfKnowledge = __esm({
+  "build-src/src/sema/selfKnowledge.ts"() {
+    SEMA_SELF_KNOWLEDGE = `# About sema (product context)
+
+You are running inside sema, an AI coding CLI. Facts you must know and act on:
+
+- sema is a fully Sema-compatible CLI (same UX, tools, and ecosystem). CLAUDE.md project memory, plugin marketplaces, MCP servers, skills, hooks and subagents all work unchanged; project-level config lives in .sema/ (e.g. .sema/commands, .sema/skills \u2014 the .claude/ analogue). Never claim sema cannot use the Sema ecosystem \u2014 it can, by design.
+- When external docs or tutorials reference the \`claude\` command, the sema equivalent is the SAME command with \`sema\` substituted (e.g. \`sema mcp add X -- npx Y\` \u2192 \`sema mcp add X -- npx Y\`). Slash commands match Sema (/help, /model, /plugin, /doctor, /config, /agents, /resume, \u2026).
+- Beyond Sema, sema adds: a local engine process the TUI drives (visible in the boot panel), model freedom (any provider via the Model Hub \u2014 \`/model\` in-session or \`sema model\`; roles/tiers configurable), cloud switching (\`sema cloud\` manages cloud registry profiles and sign-in; service/store/exec axes can each run local or cloud), central config (\`sema config\`, guided \`sema onboard\`), Sema data import (\`sema import\`), background sessions (\`sema ps\` / \`sema logs\` / \`sema attach\` / \`sema kill\`), and diagnostics (\`sema doctor\`, or /doctor in-session).
+- Plugins: /plugin opens the plugin manager (marketplaces, install, enable/disable). Skills: /skills. Both consume the open Sema plugin/skill ecosystem directly.
+- If asked what sema is: an AI coding CLI, Sema-compatible and a superset of it (engine architecture, model freedom, cloud axes). If unsure whether a capability exists, verify with \`sema --help\` or the sema-guide agent instead of denying it.`;
+    SEMA_IDENTITY_LINE = "You are part of sema, an AI coding CLI that is fully Sema-compatible (claude commands map to sema verbatim) and a superset of it (engine architecture, Model Hub, cloud axes).";
+  }
+});
+
 // build-src/src/utils/sideQuestion.ts
 function findBtwTriggerPositions(text2) {
   const positions = [];
@@ -440792,7 +440813,8 @@ ${ctx}
           // ②maxTokens 2048 封顶回答;③systemPrompt 语义兜底。
           excludeTools: side.UTILITY_EXCLUDE_ALL_TOOLS,
           maxTokens: 2048,
-          systemPrompt: "You are answering a one-off side question. You have NO tools \u2014 do not attempt to read files, run commands, or take any actions. Answer directly from the provided context in a single response."
+          // 身份行前缀(任务 #36):侧问无主 system prompt,一句话防「what is sema」答反
+          systemPrompt: `${(await Promise.resolve().then(() => (init_selfKnowledge(), selfKnowledge_exports))).SEMA_IDENTITY_LINE} You are answering a one-off side question. You have NO tools \u2014 do not attempt to read files, run commands, or take any actions. Answer directly from the provided context in a single response.`
         });
         return { response: r.text, usage: r.usage ?? EMPTY_USAGE };
       } catch (e) {
@@ -451647,7 +451669,7 @@ function Settings({
 var import_react113, import_jsx_runtime193;
 var init_cmd_config = __esm({
   "build-src/src/sema/overrides/cmd-config.tsx"() {
-    import_react113 = __toESM(require_react(), 1);
+    import_react113 = __toESM(require_react());
     init_useKeybinding();
     init_useExitOnCtrlCDWithKeybindings();
     init_useTerminalSize();
@@ -451658,7 +451680,7 @@ var init_cmd_config = __esm({
     init_Config();
     init_settings_usage();
     init_Stats();
-    import_jsx_runtime193 = __toESM(require_jsx_runtime(), 1);
+    import_jsx_runtime193 = __toESM(require_jsx_runtime());
   }
 });
 
@@ -480451,13 +480473,13 @@ var init_sema_brand = __esm({
         _doc: "Rendered as the 'What's new' feed (createWhatsNewFeed). Top version MUST be >= current app version (2.1.187) and newer than config.lastReleaseNotesSeen so the notes display and full-logo mode triggers. Pinned == app version (2.1.187) + lastReleaseNotesSeen (loginState.ts) so getRecentReleaseNotes()===[] \u2192 condensed logo (matches refs/chrome.empty-input.json).",
         version: "2.1.187",
         notes: [
-          "/btw and background utilities now use the engine's dedicated side-query channel \u2014 no session storage residue at all (previously each call left a small side-session file)",
-          "Utility calls on the new channel have no tool surface whatsoever \u2014 isolation is structural, not instruction-based",
-          "Older engines are detected automatically and keep the previous isolated-session behavior"
+          "The model now has built-in product knowledge: Claude Code compatibility (use `sema` wherever docs say `claude`), plugins, cloud, Model Hub, doctor \u2014 ask it anything about sema",
+          "Plugin slash commands (e.g. /claude-hud:setup) now show up in completion and /help Custom commands \u2014 they were loaded but hidden by an over-broad visibility rule",
+          "CC-compatibility flags that aren't wired yet now print an honest warning instead of silently doing nothing"
         ]
       },
-      productVersion: "1.0.42",
-      announcement: "sema 1.0.42 \u2014 background utility calls (/btw, session titles, recaps) now run through the engine's new side-query channel: zero session files left behind, tool access structurally impossible, and accurate token accounting."
+      productVersion: "1.0.44",
+      announcement: "sema 1.0.44 \u2014 sema now knows itself (Claude Code compatibility, plugins, cloud, Model Hub \u2014 ask it anything), plugin slash commands like /claude-hud:setup now appear in completion and /help, and unwired CC-compat flags warn honestly."
     };
   }
 });
@@ -483386,13 +483408,13 @@ var require_sema_brand = __commonJS({
         _doc: "Rendered as the 'What's new' feed (createWhatsNewFeed). Top version MUST be >= current app version (2.1.187) and newer than config.lastReleaseNotesSeen so the notes display and full-logo mode triggers. Pinned == app version (2.1.187) + lastReleaseNotesSeen (loginState.ts) so getRecentReleaseNotes()===[] \u2192 condensed logo (matches refs/chrome.empty-input.json).",
         version: "2.1.187",
         notes: [
-          "/btw and background utilities now use the engine's dedicated side-query channel \u2014 no session storage residue at all (previously each call left a small side-session file)",
-          "Utility calls on the new channel have no tool surface whatsoever \u2014 isolation is structural, not instruction-based",
-          "Older engines are detected automatically and keep the previous isolated-session behavior"
+          "The model now has built-in product knowledge: Claude Code compatibility (use `sema` wherever docs say `claude`), plugins, cloud, Model Hub, doctor \u2014 ask it anything about sema",
+          "Plugin slash commands (e.g. /claude-hud:setup) now show up in completion and /help Custom commands \u2014 they were loaded but hidden by an over-broad visibility rule",
+          "CC-compatibility flags that aren't wired yet now print an honest warning instead of silently doing nothing"
         ]
       },
-      productVersion: "1.0.42",
-      announcement: "sema 1.0.42 \u2014 background utility calls (/btw, session titles, recaps) now run through the engine's new side-query channel: zero session files left behind, tool access structurally impossible, and accurate token accounting."
+      productVersion: "1.0.44",
+      announcement: "sema 1.0.44 \u2014 sema now knows itself (Claude Code compatibility, plugins, cloud, Model Hub \u2014 ask it anything), plugin slash commands like /claude-hud:setup now appear in completion and /help, and unwired CC-compat flags warn honestly."
     };
   }
 });
@@ -530605,16 +530627,20 @@ async function semaEngineNonStreamingLeg({
   if (options.outputFormat?.schema) {
     objective += side.jsonDisciplineSuffix(options.outputFormat.schema);
   }
-  const text2 = await side.engineUtilityText({
+  const r = await side.engineUtilityTask({
     objective,
     signal,
     maxTokens: options.maxOutputTokensOverride,
+    cheapSlot: true,
     // 池内模型透传(A2 兜底):queryWithModel/advisor 显式选池模型时按所选路由;CC 名走 cheap/默认
     modelRef: await side.resolvePoolModelRef(options.model)
   });
-  if (text2 === null) return null;
+  const text2 = r.text;
   const content = options.outputFormat?.schema ? side.extractJsonObjectText(text2) ?? text2 : text2;
-  return createAssistantMessage({ content });
+  return createAssistantMessage({
+    content,
+    ...r.usage ? { usage: r.usage } : {}
+  });
 }
 async function queryModelWithoutStreaming({
   messages,
@@ -606991,8 +607017,8 @@ function _temp158() {
 var import_compiler_runtime312, import_react310, import_jsx_runtime458, DESKTOP_UPSELL_DEFAULT;
 var init_DesktopUpsellStartup = __esm({
   "build-src/src/components/DesktopUpsell/DesktopUpsellStartup.tsx"() {
-    import_compiler_runtime312 = __toESM(require_compiler_runtime(), 1);
-    import_react310 = __toESM(require_react(), 1);
+    import_compiler_runtime312 = __toESM(require_compiler_runtime());
+    import_react310 = __toESM(require_react());
     init_ink2();
     init_growthbook_advisor_flag();
     init_analytics_index();
@@ -607000,7 +607026,7 @@ var init_DesktopUpsellStartup = __esm({
     init_select();
     init_DesktopHandoff();
     init_PermissionDialog();
-    import_jsx_runtime458 = __toESM(require_jsx_runtime(), 1);
+    import_jsx_runtime458 = __toESM(require_jsx_runtime());
     DESKTOP_UPSELL_DEFAULT = {
       enable_shortcut_tip: false,
       enable_startup_dialog: false
@@ -609355,8 +609381,8 @@ function _temp161() {
 var import_compiler_runtime316, import_react314, SETTINGS_ERRORS_NOTIFICATION_KEY;
 var init_useSettingsErrors = __esm({
   "build-src/src/hooks/notifs/useSettingsErrors.tsx"() {
-    import_compiler_runtime316 = __toESM(require_compiler_runtime(), 1);
-    import_react314 = __toESM(require_react(), 1);
+    import_compiler_runtime316 = __toESM(require_compiler_runtime());
+    import_react314 = __toESM(require_react());
     init_notifications();
     init_state();
     init_allErrors();
@@ -630118,6 +630144,10 @@ function toLiveRequest(req, capturedSessionId) {
   if (typeof out6.scenario === "string" && SEMA_MOCK_SCENARIO_KEYS.has(out6.scenario)) {
     delete out6.scenario;
   }
+  {
+    const settings2 = out6.settings ?? {};
+    out6.settings = { ...settings2, outputStyle: withSelfKnowledgeOutputStyle(settings2.outputStyle) };
+  }
   if (capturedSessionId) {
     out6.sessionId = capturedSessionId;
   } else if (out6.sessionId === mockClientIds.sessionId) {
@@ -630372,6 +630402,7 @@ var init_liveClient = __esm({
     init_agentsWire();
     init_detachWire();
     init_headlessReconnectWire();
+    init_selfKnowledge();
     init_mockClient();
     ENGINE_TO_CC_TOOL = {
       bash: "Bash",
@@ -653491,6 +653522,30 @@ async function run() {
     return value;
   })).option("--sandbox <profile>", `Sandbox image profile for submitted runs: a profile name (explicit; k8s-lane workers only \u2014 list with 'sema cloud images list'), or 'auto' to let the model pick via its SelectEnvironment tool (advisory; choice + reason are echoed in the reply). Omit for the worker default image.`).option("--scenario <name>", `Engine scenario for submitted runs (only works with --print): route the run through a deployment-defined scenario (tool roster + system prompt). Unknown names fall back to the default scenario. Omit for the default scenario; a persistent default can be set via SEMA_HEADLESS_SCENARIO in the settings.json env block.`).option("--no-final-verify", `Disable the default final-verification pass for submitted runs (only works with --print). By default, headless -p runs that write files get up to two extra verification turns before finishing; this flag restores the upstream-aligned behaviour (no verification pass). A persistent default can be set via SEMA_HEADLESS_FINAL_VERIFY=false in the settings.json env block. Skipped automatically when a Stop hook is configured.`).option("--deadline <sec>", `Soft wall-clock budget in seconds for submitted runs (only works with --print; sema superset \u2014 no upstream equivalent). The engine paces itself against the deadline (pacing nudges + per-call caps) and finalizes gracefully near it; integer between 30 and 86400. A persistent default can be set via SEMA_HEADLESS_DEADLINE_SEC in the settings.json env block.`).option("--agent <agent>", `Agent for the current session. Overrides the 'agent' setting.`).option("--betas <betas...>", "Beta headers to include in API requests (API key users only)").option("--fallback-model <model>", "Enable automatic fallback to specified model when default model is overloaded (only works with --print)").addOption(new Option("--workload <tag>", "Workload tag for billing-header attribution (cc_workload). Process-scoped; set by SDK daemon callers that spawn subprocesses for cron work. (only works with --print)").hideHelp()).option("--settings <file-or-json>", "Path to a settings JSON file or a JSON string to load additional settings from").option("--add-dir <directories...>", "Additional directories to allow tool access to").option("--ide", "Automatically connect to IDE on startup if exactly one valid IDE is available", () => true).option("--strict-mcp-config", "Only use MCP servers from --mcp-config, ignoring all other MCP configurations", () => true).option("--session-id <uuid>", "Use a specific session ID for the conversation (must be a valid UUID)").option("-n, --name <name>", "Set a display name for this session (shown in /resume and terminal title)").option("--agents <json>", `JSON object defining custom agents (e.g. '{"reviewer": {"description": "Reviews code", "prompt": "You are a code reviewer"}}')`).option("--setting-sources <sources>", "Comma-separated list of setting sources to load (user, project, local).").option("--plugin-dir <path>", "Load plugins from a directory for this session only (repeatable: --plugin-dir A --plugin-dir B)", (val, prev) => [...prev, val], []).addOption(new Option("--plugin-dir-no-mcp <path>", "Like --plugin-dir but the engine will not read this plugin's .mcp.json (caller owns its MCP connections)").argParser((val, prev) => [...prev, val]).default([]).hideHelp()).option("--plugin-url <url>", "Fetch a plugin .zip from a URL for this session only (repeatable: --plugin-url A --plugin-url B)", (val, prev) => [...prev, ...val.split(/\s+/).filter(Boolean)], []).option("--disable-slash-commands", "Disable all skills", () => true).option("--chrome", "Enable Claude in Chrome integration").option("--no-chrome", "Disable Claude in Chrome integration").option("--file <specs...>", "File resources to download at startup. Format: file_id:relative_path (e.g., --file file_abc:doc.txt file_def:img.png)").action(async (prompt, options) => {
     profileCheckpoint("action_handler_start");
+    {
+      const UNWIRED_FLAGS = [
+        ["thinkingDisplay", "--thinking-display"],
+        ["promptSuggestions", "--prompt-suggestions"],
+        ["sessionMirror", "--session-mirror"],
+        ["excludeDynamicSystemPromptSections", "--exclude-dynamic-system-prompt-sections"],
+        ["replyOnResume", "--reply-on-resume"],
+        ["pluginDirNoMcp", "--plugin-dir-no-mcp"],
+        ["pluginUrl", "--plugin-url"],
+        ["background", "--bg/--background"],
+        ["bg", "--bg/--background"],
+        ["axScreenReader", "--ax-screen-reader"]
+      ];
+      const warned2 = /* @__PURE__ */ new Set();
+      for (const [key, flag] of UNWIRED_FLAGS) {
+        const v2 = options[key];
+        const set2 = v2 !== void 0 && v2 !== false && !(Array.isArray(v2) && v2.length === 0);
+        if (set2 && !warned2.has(flag)) {
+          warned2.add(flag);
+          process.stderr.write(source_default.yellow(`${flag} is recognized for CC compatibility but not wired in this sema build yet \u2014 it currently has no effect.
+`));
+        }
+      }
+    }
     if (options.bare) {
       process.env.SEMA_CODE_SIMPLE = "1";
     }
@@ -655599,7 +655654,7 @@ Auth: unix socket -R \u2192 local proxy`, "info");
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("sema 1.0.42", "-v, --version", "Output the version number");
+  }).version("sema 1.0.44", "-v, --version", "Output the version number");
   program2.option("-w, --worktree [name]", "Create a new git worktree for this session (optionally specify a name)");
   program2.option("--tmux", "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.");
   if (canUserConfigureAdvisor()) {
@@ -660769,7 +660824,9 @@ function resolveCommandGate(cmd, caps) {
     return { state: "denied", visible: false, degraded: false, hidden: false, reason: "config-deny" };
   }
   const explicitMode = override?.mode;
-  const isUnbucketedFallthrough = !bucketOf(name) && explicitMode !== "allow" && explicitMode !== "deny";
+  const source = cmd.source;
+  const isBuiltinFace = source === void 0 || source === "builtin";
+  const isUnbucketedFallthrough = isBuiltinFace && !bucketOf(name) && explicitMode !== "allow" && explicitMode !== "deny";
   const hidden = override?.hidden === true || isUnbucketedFallthrough;
   const requiredCapability = override?.requiredCapability;
   if (requiredCapability) {