@ken-jo/agent-connector 0.4.0 → 0.4.6

package/dist/{mux-DSSH4AFS.js → mux-5XZFB44C.js}

@@ -5,21 +5,23 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-IW77FFNX.js";
+} from "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-BXGFUENQ.js";
+} from "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
 // src/adapters/mux/index.ts
-import { existsSync } from "fs";
+import { existsSync, statSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { dirname, join } from "path";
 var HOST = "mux";
 var MCP_ROOT_KEY = "servers";
+var MUX_SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var MUX_SKILL_NAME_MAX = 64;
 function quoteToken(token) {
   return /\s/.test(token) ? `"${token}"` : token;
 }
@@ -47,7 +49,16 @@ var MuxAdapter = class extends BaseAdapter {
     canModifyOutput: false,
     canInjectSessionContext: false,
     // Mux's command-string server entry is stdio-only.
-    transports: ["stdio"]
+    transports: ["stdio"],
+    // Content surface: Mux auto-discovers dir-per-skill SKILL.md from its
+    // workspace-local and global roots (mux.coder.com/agents/agent-skills,
+    // fetched 2026-06-16):
+    //   project → <projectDir>/.mux/skills/<name>/SKILL.md (workspace-local)
+    //   user    → ~/.mux/skills/<name>/SKILL.md (global, Mux-specific)
+    // The skill directory name MUST match ^[a-z0-9]+(?:-[a-z0-9]+)*$ (1–64
+    // chars) and the SKILL.md `name` field must equal it — a name that cannot
+    // be represented is skip-warned (see installSkills).
+    supportsSkills: true
   };
   // ── Detection ────────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
@@ -177,6 +188,145 @@ var MuxAdapter = class extends BaseAdapter {
       }
     ];
   }
+  // ── Content surface: skills (dir-per-skill SKILL.md) ─────────────────────
+  // CONTENT-ONLY: pure native-file writers, mirroring goose/openclaw. No
+  // runtime dispatch, no home-bin pointer, no telemetry wrap. Idempotent
+  // (byte-identical → skip) via writeContentFile and reversible via
+  // removeContentFile + removeDirIfEmpty. Honors platforms["mux"].skills ===
+  // false. No mcp.jsonc entry — Mux auto-discovers the skills dirs.
+  //
+  // Native locations (mux.coder.com/agents/agent-skills):
+  //   project → <projectDir>/.mux/skills/<name>/SKILL.md (workspace-local)
+  //   user    → ~/.mux/skills/<name>/SKILL.md (global, Mux-specific)
+  // The dir name MUST match MUX_SKILL_NAME_RE (1–64 chars) and the SKILL.md
+  // `name` field must equal it — a name that can't be represented is skip-warned.
+  /** The skills ROOT dir for ctx.scope (parent of every per-skill dir). */
+  skillsDir(ctx) {
+    return join(this.getConfigDir(ctx), "skills");
+  }
+  /** Per-skill directory: <skillsDir>/<name>. */
+  skillDir(ctx, name) {
+    return join(this.skillsDir(ctx), name);
+  }
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for mux" }];
+    }
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      if (!this.isValidSkillName(skill.name)) {
+        changes.push({
+          platform: this.id,
+          action: "warn",
+          detail: `skill "${skill.name}" cannot be represented on mux (name must match ${MUX_SKILL_NAME_RE.source}, 1\u2013${MUX_SKILL_NAME_MAX} chars); skipped`
+        });
+        continue;
+      }
+      const dir = this.skillDir(ctx, skill.name);
+      const blockingFile = this.firstFileOnSkillPath(ctx, dir);
+      if (blockingFile !== null) {
+        changes.push({
+          platform: this.id,
+          action: "warn",
+          path: blockingFile,
+          detail: `${blockingFile} is a file, not a directory; skill "${skill.name}" skipped`
+        });
+        continue;
+      }
+      changes.push(
+        this.writeContentFile(join(dir, "SKILL.md"), this.renderSkill(skill), ctx.dryRun)
+      );
+      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `skill resource "${rel}" escapes the skill dir; skipped`
+          });
+          continue;
+        }
+        changes.push(this.writeContentFile(target, contents, ctx.dryRun));
+      }
+    }
+    return changes;
+  }
+  uninstallSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      if (!this.isValidSkillName(skill.name)) continue;
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(this.removeContentFile(join(dir, "SKILL.md"), ctx.dryRun));
+      for (const rel of Object.keys(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) continue;
+        changes.push(this.removeContentFile(target, ctx.dryRun));
+      }
+      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));
+    }
+    if (changes.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "no installable skills to remove" }];
+    }
+    return changes;
+  }
+  /** True when a skill name is representable as a Mux skill directory name. */
+  isValidSkillName(name) {
+    return name.length >= 1 && name.length <= MUX_SKILL_NAME_MAX && MUX_SKILL_NAME_RE.test(name);
+  }
+  /**
+   * Walk from the skills root down to `leaf` and return the FIRST segment that
+   * exists as a regular file (a mkdir there throws ENOTDIR), else null — so
+   * installSkills can skip-warn instead of crashing.
+   */
+  firstFileOnSkillPath(ctx, leaf) {
+    const root = this.skillsDir(ctx);
+    const segments = [];
+    let cur = leaf;
+    while (cur.length >= root.length) {
+      segments.unshift(cur);
+      if (cur === root) break;
+      const parent = dirname(cur);
+      if (parent === cur) break;
+      cur = parent;
+    }
+    for (const p of segments) {
+      if (!existsSync(p)) return null;
+      try {
+        if (statSync(p).isFile()) return p;
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+  /**
+   * Render a skill's SKILL.md: frontmatter (name, description + optional model,
+   * allowed-tools, disable-model-invocation) + body. UNIFORM with every other
+   * skill-supporting platform — only the parent dir differs. Mux requires the
+   * `name` field to equal the directory name, which installSkills guarantees.
+   */
+  renderSkill(skill) {
+    const frontmatter = {
+      name: skill.name,
+      description: skill.description
+    };
+    if (skill.model !== void 0) frontmatter.model = skill.model;
+    const allow = skill.tools?.allow;
+    if (allow && allow.length > 0) frontmatter["allowed-tools"] = allow.join(", ");
+    if (skill.disableModelInvocation !== void 0) {
+      frontmatter["disable-model-invocation"] = skill.disableModelInvocation;
+    }
+    if (skill.extra) Object.assign(frontmatter, skill.extra);
+    return this.renderFrontmatterMd(frontmatter, skill.body);
+  }
   // ── Diagnostics ──────────────────────────────────────────────────────────
   getHealthChecks(ctx) {
     const mcpPath = this.getServerConfigPath(ctx);
@@ -215,4 +365,4 @@ export {
   adapter,
   mux_default as default
 };
-//# sourceMappingURL=mux-DSSH4AFS.js.map
+//# sourceMappingURL=mux-5XZFB44C.js.map

package/dist/mux-5XZFB44C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/mux/index.ts"],"sourcesContent":["/**\n * adapters/mux — Mux (Coder) platform adapter for agent-connector.\n *\n * Mux is an **mcp-only** host: it exposes no lifecycle hook system, and MCP is\n * its extensibility mechanism. This adapter therefore installs only the MCP\n * server and reports hooks as unavailable — the same shape as the Warp\n * reference adapter.\n *\n * MCP config:\n *   - user scope    → ~/.mux/mcp.jsonc\n *   - project scope → <projectDir>/.mux/mcp.jsonc\n *   Both are JSONC (comments allowed) but we write strict JSON. The root key is\n *   \"servers\", and this file doubles as the (non-existent) hook config — there\n *   is no separate hook file here.\n *\n * QUIRK: Mux models each server entry as a single shell-command STRING, not an\n * object. So `servers[id]` is `\"<exe> <arg1> <arg2> ...\"` — space-joined, with\n * any token containing whitespace double-quoted. We therefore build that string\n * ourselves and upsert it idempotently (the generic object upsert helper would\n * write the wrong shape). When telemetry-wrapping, the string is the home-bin\n * `serve` wrapper command followed by its args.\n *\n * Mux documents no native `${env:VAR}` interpolation token, so env-refs in the\n * command/args are resolved to literals at install time. The string form has no\n * place for an env map, so server.env is dropped with no native equivalent.\n */\n\nimport { existsSync, statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, InstallContext } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookParadigm,\n  PlatformCapabilities,\n  PlatformId,\n  ServerDef,\n  SkillDef,\n} from \"../../core/types.js\";\nimport { resolveEnvRefs, resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\n\nconst HOST: PlatformId = \"mux\";\nconst MCP_ROOT_KEY = \"servers\";\n\n/**\n * Mux enforces this exact pattern (1–64 chars) on a SKILL directory name, and\n * the SKILL.md `name` field MUST equal the directory name\n * (mux.coder.com/agents/agent-skills). A skill name that does not match is\n * skip-warned rather than written to a dir Mux would reject.\n */\nconst MUX_SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\nconst MUX_SKILL_NAME_MAX = 64;\n\n/** Quote a token only when it contains whitespace (Mux command-string form). */\nfunction quoteToken(token: string): string {\n  return /\\s/.test(token) ? `\"${token}\"` : token;\n}\n\n/** Join an executable + args into Mux's single shell-command string. */\nfunction buildCommandString(command: string, args: readonly string[]): string {\n  return [command, ...args].map(quoteToken).join(\" \");\n}\n\nexport class MuxAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Mux\";\n  readonly paradigm: HookParadigm = \"mcp-only\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default\n    // (memoryTargets: project <projectDir>/AGENTS.md; user scope where documented).\n    supportsMemory: true,\n    // Mux has no lifecycle hook system — every hook capability is false.\n    preToolUse: false,\n    postToolUse: false,\n    preCompact: false,\n    sessionStart: false,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    // Mux's command-string server entry is stdio-only.\n    transports: [\"stdio\"],\n    // Content surface: Mux auto-discovers dir-per-skill SKILL.md from its\n    // workspace-local and global roots (mux.coder.com/agents/agent-skills,\n    // fetched 2026-06-16):\n    //   project → <projectDir>/.mux/skills/<name>/SKILL.md (workspace-local)\n    //   user    → ~/.mux/skills/<name>/SKILL.md (global, Mux-specific)\n    // The skill directory name MUST match ^[a-z0-9]+(?:-[a-z0-9]+)*$ (1–64\n    // chars) and the SKILL.md `name` field must equal it — a name that cannot\n    // be represented is skip-warned (see installSkills).\n    supportsSkills: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".mux\");\n    const userMcp = join(userDir, \"mcp.jsonc\");\n    const projDir = join(projectDir, \".mux\");\n    const projMcp = join(projDir, \"mcp.jsonc\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userMcp);\n    const projInstalled = existsSync(projDir) || existsSync(projMcp);\n    const installed = userInstalled || projInstalled;\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projMcp : userMcp;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `found Mux config (${scope})`\n        : `no Mux config at ${userDir} or ${projDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".mux\")\n      : join(homedir(), \".mux\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp.jsonc\");\n  }\n\n  /**\n   * Mux has no hook file — hooks are not a thing here. The hook \"config path\"\n   * is the same mcp.jsonc so the generic doctor/backup behave sensibly.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  // ── MCP server install / uninstall ───────────────────────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector, dryRun } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for mux\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const path = this.getServerConfigPath(ctx);\n\n    if (server.transport !== \"stdio\" || !server.command) {\n      // Mux's command-string entry is stdio-only; remote transports skip.\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path,\n          detail: `transport \"${server.transport}\" not registrable (mux expects a stdio command string)`,\n        },\n      ];\n    }\n\n    const entry = this.renderCommandString(ctx, server);\n\n    // QUIRK: each server value is a STRING, not an object — so we cannot use the\n    // generic object upsert helper. Build the string and upsert idempotently.\n    const cfg =\n      this.readJson<Record<string, Record<string, unknown>>>(path) ?? {};\n    const bucket = (cfg[MCP_ROOT_KEY] ??= {});\n    const before = JSON.stringify(bucket[connector.id]);\n    const after = JSON.stringify(entry);\n\n    let action: ChangeRecord[\"action\"];\n    if (before === undefined) action = \"create\";\n    else if (before === after) action = \"skip\";\n    else action = \"update\";\n\n    if (action !== \"skip\") {\n      bucket[connector.id] = entry;\n      this.writeJson(path, cfg, dryRun);\n    }\n    return [\n      { platform: this.id, action, path, detail: `${MCP_ROOT_KEY}.${connector.id}` },\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const path = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(path, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /**\n   * Render a stdio ServerDef into Mux's single shell-command string. Honors the\n   * telemetry serve-wrapper and resolves every `${env:VAR}` to a literal (Mux\n   * documents no native interpolation token).\n   */\n  private renderCommandString(ctx: InstallContext, server: ServerDef): string {\n    let command = server.command ?? \"\";\n    let args = [...(server.args ?? [])];\n\n    // Transparent telemetry wrapping: route the real command through\n    // `<homeBin> serve --connector <id> -- <command> <args...>`.\n    if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n      const wrapped = buildServeWrapperCommand(\n        ctx.homeBinPath,\n        ctx.connector.id,\n        command,\n        args,\n        ctx.scope,\n        this.id,\n      );\n      command = wrapped.command;\n      args = wrapped.args;\n    }\n\n    // Resolve env-refs to literals (Mux has no native interpolation token).\n    command = resolveEnvRefs(command);\n    args = resolveEnvRefsDeep(args);\n\n    return buildCommandString(command, args);\n  }\n\n  // ── Hooks (unavailable — Mux is mcp-only) ─────────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Mux is mcp-only)\",\n      },\n    ];\n  }\n\n  uninstallHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Mux is mcp-only)\",\n      },\n    ];\n  }\n\n  // ── Content surface: skills (dir-per-skill SKILL.md) ─────────────────────\n  // CONTENT-ONLY: pure native-file writers, mirroring goose/openclaw. No\n  // runtime dispatch, no home-bin pointer, no telemetry wrap. Idempotent\n  // (byte-identical → skip) via writeContentFile and reversible via\n  // removeContentFile + removeDirIfEmpty. Honors platforms[\"mux\"].skills ===\n  // false. No mcp.jsonc entry — Mux auto-discovers the skills dirs.\n  //\n  // Native locations (mux.coder.com/agents/agent-skills):\n  //   project → <projectDir>/.mux/skills/<name>/SKILL.md (workspace-local)\n  //   user    → ~/.mux/skills/<name>/SKILL.md (global, Mux-specific)\n  // The dir name MUST match MUX_SKILL_NAME_RE (1–64 chars) and the SKILL.md\n  // `name` field must equal it — a name that can't be represented is skip-warned.\n\n  /** The skills ROOT dir for ctx.scope (parent of every per-skill dir). */\n  private skillsDir(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"skills\");\n  }\n\n  /** Per-skill directory: <skillsDir>/<name>. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.skillsDir(ctx), name);\n  }\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for mux\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      // Mux REQUIRES the dir name (and SKILL.md `name`) to match its pattern;\n      // a name we cannot represent is skip-warned rather than written to a dir\n      // Mux would reject (the honesty bar — never write an unreadable path).\n      if (!this.isValidSkillName(skill.name)) {\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          detail:\n            `skill \"${skill.name}\" cannot be represented on mux ` +\n            `(name must match ${MUX_SKILL_NAME_RE.source}, 1–${MUX_SKILL_NAME_MAX} chars); skipped`,\n        });\n        continue;\n      }\n      const dir = this.skillDir(ctx, skill.name);\n      // Guard a skills path occupied by a regular FILE (mkdir would throw\n      // ENOTDIR): skip-warn rather than crash (cline `.clinerules`-is-a-file\n      // precedent).\n      const blockingFile = this.firstFileOnSkillPath(ctx, dir);\n      if (blockingFile !== null) {\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          path: blockingFile,\n          detail: `${blockingFile} is a file, not a directory; skill \"${skill.name}\" skipped`,\n        });\n        continue;\n      }\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), this.renderSkill(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir.\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      // Skip names install never wrote (invalid → never on disk under our dir).\n      if (!this.isValidSkillName(skill.name)) continue;\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    if (changes.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"no installable skills to remove\" }];\n    }\n    return changes;\n  }\n\n  /** True when a skill name is representable as a Mux skill directory name. */\n  private isValidSkillName(name: string): boolean {\n    return name.length >= 1 && name.length <= MUX_SKILL_NAME_MAX && MUX_SKILL_NAME_RE.test(name);\n  }\n\n  /**\n   * Walk from the skills root down to `leaf` and return the FIRST segment that\n   * exists as a regular file (a mkdir there throws ENOTDIR), else null — so\n   * installSkills can skip-warn instead of crashing.\n   */\n  private firstFileOnSkillPath(ctx: InstallContext, leaf: string): string | null {\n    const root = this.skillsDir(ctx);\n    const segments: string[] = [];\n    let cur = leaf;\n    while (cur.length >= root.length) {\n      segments.unshift(cur);\n      if (cur === root) break;\n      const parent = dirname(cur);\n      if (parent === cur) break;\n      cur = parent;\n    }\n    for (const p of segments) {\n      if (!existsSync(p)) return null;\n      try {\n        if (statSync(p).isFile()) return p;\n      } catch {\n        return null;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Render a skill's SKILL.md: frontmatter (name, description + optional model,\n   * allowed-tools, disable-model-invocation) + body. UNIFORM with every other\n   * skill-supporting platform — only the parent dir differs. Mux requires the\n   * `name` field to equal the directory name, which installSkills guarantees.\n   */\n  private renderSkill(skill: SkillDef): string {\n    const frontmatter: Record<string, unknown> = {\n      name: skill.name,\n      description: skill.description,\n    };\n    if (skill.model !== undefined) frontmatter.model = skill.model;\n    const allow = skill.tools?.allow;\n    if (allow && allow.length > 0) frontmatter[\"allowed-tools\"] = allow.join(\", \");\n    if (skill.disableModelInvocation !== undefined) {\n      frontmatter[\"disable-model-invocation\"] = skill.disableModelInvocation;\n    }\n    if (skill.extra) Object.assign(frontmatter, skill.extra);\n    return this.renderFrontmatterMd(frontmatter, skill.body);\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const mcpPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    return [\n      {\n        name: `${this.name}: mcp.jsonc present`,\n        check: () =>\n          existsSync(mcpPath)\n            ? { status: \"OK\", detail: mcpPath }\n            : { status: \"FAIL\", detail: `not found: ${mcpPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          // Only assert what the connector declares: a server-less connector\n          // never writes an mcpServers entry, so its absence is healthy.\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(\n            mcpPath,\n          );\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no ${MCP_ROOT_KEY} in ${mcpPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `${MCP_ROOT_KEY}.${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no ${MCP_ROOT_KEY}.${connectorId} in ${mcpPath}`,\n              };\n        },\n      },\n    ];\n  }\n}\n\nexport const adapter = new MuxAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,SAAS,YAAY,gBAAgB;AACrC,SAAS,eAAe;AACxB,SAAS,SAAS,YAAY;AAoB9B,IAAM,OAAmB;AACzB,IAAM,eAAe;AAQrB,IAAM,oBAAoB;AAC1B,IAAM,qBAAqB;AAG3B,SAAS,WAAW,OAAuB;AACzC,SAAO,KAAK,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM;AAC3C;AAGA,SAAS,mBAAmB,SAAiB,MAAiC;AAC5E,SAAO,CAAC,SAAS,GAAG,IAAI,EAAE,IAAI,UAAU,EAAE,KAAK,GAAG;AACpD;AAEO,IAAM,aAAN,cAAyB,YAA+B;AAAA,EACpD,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA;AAAA,IAG5C,gBAAgB;AAAA;AAAA,IAEhB,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,MAAM;AAAA,IACN,cAAc;AAAA,IACd,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,yBAAyB;AAAA;AAAA,IAEzB,YAAY,CAAC,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASpB,gBAAgB;AAAA,EAClB;AAAA;AAAA,EAIA,gBAAgB,YAAsC;AACpD,UAAM,UAAU,KAAK,QAAQ,GAAG,MAAM;AACtC,UAAM,UAAU,KAAK,SAAS,WAAW;AACzC,UAAM,UAAU,KAAK,YAAY,MAAM;AACvC,UAAM,UAAU,KAAK,SAAS,WAAW;AAEzC,UAAM,gBAAgB,WAAW,OAAO,KAAK,WAAW,OAAO;AAC/D,UAAM,gBAAgB,WAAW,OAAO,KAAK,WAAW,OAAO;AAC/D,UAAM,YAAY,iBAAiB;AACnC,UAAM,QAAQ,iBAAiB,CAAC,gBAAgB,YAAY;AAC5D,UAAM,aAAa,UAAU,YAAY,UAAU;AAEnD,WAAO;AAAA,MACL,IAAI,KAAK;AAAA,MACT,MAAM,KAAK;AAAA,MACX;AAAA,MACA,UAAU,KAAK;AAAA,MACf,cAAc,KAAK;AAAA,MACnB;AAAA,MACA;AAAA,MACA,QAAQ,YACJ,qBAAqB,KAAK,MAC1B,oBAAoB,OAAO,OAAO,OAAO;AAAA,MAC7C,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA,EAIA,aAAa,KAA6B;AACxC,WAAO,IAAI,UAAU,YACjB,KAAK,IAAI,YAAY,MAAM,IAC3B,KAAK,QAAQ,GAAG,MAAM;AAAA,EAC5B;AAAA,EAEA,oBAAoB,KAA6B;AAC/C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,WAAW;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,oBAAoB,GAAG;AAAA,EACrC;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,EAAE,WAAW,OAAO,IAAI;AAC9B,UAAM,WAAW,UAAU,UAAU,IAAI,GAAG;AAC5C,QAAI,CAAC,UAAU,UAAU,aAAa,OAAO;AAC3C,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QAAQ,UAAU,SACd,yCACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SACJ,YAAY,OAAO,aAAa,WAC5B,EAAE,GAAG,UAAU,QAAQ,GAAG,SAAS,IACnC,UAAU;AAEhB,UAAM,OAAO,KAAK,oBAAoB,GAAG;AAEzC,QAAI,OAAO,cAAc,WAAW,CAAC,OAAO,SAAS;AAEnD,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR;AAAA,UACA,QAAQ,cAAc,OAAO,SAAS;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,KAAK,oBAAoB,KAAK,MAAM;AAIlD,UAAM,MACJ,KAAK,SAAkD,IAAI,KAAK,CAAC;AACnE,UAAM,SAAU,IAAI,YAAY,MAAM,CAAC;AACvC,UAAM,SAAS,KAAK,UAAU,OAAO,UAAU,EAAE,CAAC;AAClD,UAAM,QAAQ,KAAK,UAAU,KAAK;AAElC,QAAI;AACJ,QAAI,WAAW,OAAW,UAAS;AAAA,aAC1B,WAAW,MAAO,UAAS;AAAA,QAC/B,UAAS;AAEd,QAAI,WAAW,QAAQ;AACrB,aAAO,UAAU,EAAE,IAAI;AACvB,WAAK,UAAU,MAAM,KAAK,MAAM;AAAA,IAClC;AACA,WAAO;AAAA,MACL,EAAE,UAAU,KAAK,IAAI,QAAQ,MAAM,QAAQ,GAAG,YAAY,IAAI,UAAU,EAAE,GAAG;AAAA,IAC/E;AAAA,EACF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,OAAO,KAAK,oBAAoB,GAAG;AACzC,WAAO;AAAA,MACL,KAAK,qBAAqB,MAAM,cAAc,IAAI,UAAU,IAAI,IAAI,MAAM;AAAA,IAC5E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,oBAAoB,KAAqB,QAA2B;AAC1E,QAAI,UAAU,OAAO,WAAW;AAChC,QAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAIlC,QAAI,uBAAuB,QAAQ,IAAI,UAAU,SAAS,GAAG;AAC3D,YAAM,UAAU;AAAA,QACd,IAAI;AAAA,QACJ,IAAI,UAAU;AAAA,QACd;AAAA,QACA;AAAA,QACA,IAAI;AAAA,QACJ,KAAK;AAAA,MACP;AACA,gBAAU,QAAQ;AAClB,aAAO,QAAQ;AAAA,IACjB;AAGA,cAAU,eAAe,OAAO;AAChC,WAAO,mBAAmB,IAAI;AAE9B,WAAO,mBAAmB,SAAS,IAAI;AAAA,EACzC;AAAA;AAAA,EAIA,aAAa,MAAsC;AACjD,WAAO;AAAA,MACL;AAAA,QACE,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EAEA,eAAe,MAAsC;AACnD,WAAO;AAAA,MACL;AAAA,QACE,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBQ,UAAU,KAA6B;AAC7C,WAAO,KAAK,KAAK,aAAa,GAAG,GAAG,QAAQ;AAAA,EAC9C;AAAA;AAAA,EAGQ,SAAS,KAAqB,MAAsB;AAC1D,WAAO,KAAK,KAAK,UAAU,GAAG,GAAG,IAAI;AAAA,EACvC;AAAA,EAES,cAAc,KAAqC;AAC1D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,WAAW,OAAO;AAC/C,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,0BAA0B,CAAC;AAAA,IAClF;AACA,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AAIpC,UAAI,CAAC,KAAK,iBAAiB,MAAM,IAAI,GAAG;AACtC,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QACE,UAAU,MAAM,IAAI,mDACA,kBAAkB,MAAM,YAAO,kBAAkB;AAAA,QACzE,CAAC;AACD;AAAA,MACF;AACA,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AAIzC,YAAM,eAAe,KAAK,qBAAqB,KAAK,GAAG;AACvD,UAAI,iBAAiB,MAAM;AACzB,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ,GAAG,YAAY,uCAAuC,MAAM,IAAI;AAAA,QAC1E,CAAC;AACD;AAAA,MACF;AACA,cAAQ;AAAA,QACN,KAAK,iBAAiB,KAAK,KAAK,UAAU,GAAG,KAAK,YAAY,KAAK,GAAG,IAAI,MAAM;AAAA,MAClF;AAGA,iBAAW,CAAC,KAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,aAAa,CAAC,CAAC,GAAG;AACnE,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,MAAM;AACnB,kBAAQ,KAAK;AAAA,YACX,UAAU,KAAK;AAAA,YACf,QAAQ;AAAA,YACR,QAAQ,mBAAmB,GAAG;AAAA,UAChC,CAAC;AACD;AAAA,QACF;AACA,gBAAQ,KAAK,KAAK,iBAAiB,QAAQ,UAAU,IAAI,MAAM,CAAC;AAAA,MAClE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAES,gBAAgB,KAAqC;AAC5D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AAEpC,UAAI,CAAC,KAAK,iBAAiB,MAAM,IAAI,EAAG;AACxC,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AAGzC,cAAQ,KAAK,KAAK,kBAAkB,KAAK,KAAK,UAAU,GAAG,IAAI,MAAM,CAAC;AACtE,iBAAW,OAAO,OAAO,KAAK,MAAM,aAAa,CAAC,CAAC,GAAG;AACpD,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,KAAM;AACrB,gBAAQ,KAAK,KAAK,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAAA,MACzD;AAGA,cAAQ,KAAK,KAAK,iBAAiB,KAAK,IAAI,MAAM,CAAC;AAAA,IACrD;AACA,QAAI,QAAQ,WAAW,GAAG;AACxB,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,kCAAkC,CAAC;AAAA,IAC1F;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGQ,iBAAiB,MAAuB;AAC9C,WAAO,KAAK,UAAU,KAAK,KAAK,UAAU,sBAAsB,kBAAkB,KAAK,IAAI;AAAA,EAC7F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,qBAAqB,KAAqB,MAA6B;AAC7E,UAAM,OAAO,KAAK,UAAU,GAAG;AAC/B,UAAM,WAAqB,CAAC;AAC5B,QAAI,MAAM;AACV,WAAO,IAAI,UAAU,KAAK,QAAQ;AAChC,eAAS,QAAQ,GAAG;AACpB,UAAI,QAAQ,KAAM;AAClB,YAAM,SAAS,QAAQ,GAAG;AAC1B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AACA,eAAW,KAAK,UAAU;AACxB,UAAI,CAAC,WAAW,CAAC,EAAG,QAAO;AAC3B,UAAI;AACF,YAAI,SAAS,CAAC,EAAE,OAAO,EAAG,QAAO;AAAA,MACnC,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,YAAY,OAAyB;AAC3C,UAAM,cAAuC;AAAA,MAC3C,MAAM,MAAM;AAAA,MACZ,aAAa,MAAM;AAAA,IACrB;AACA,QAAI,MAAM,UAAU,OAAW,aAAY,QAAQ,MAAM;AACzD,UAAM,QAAQ,MAAM,OAAO;AAC3B,QAAI,SAAS,MAAM,SAAS,EAAG,aAAY,eAAe,IAAI,MAAM,KAAK,IAAI;AAC7E,QAAI,MAAM,2BAA2B,QAAW;AAC9C,kBAAY,0BAA0B,IAAI,MAAM;AAAA,IAClD;AACA,QAAI,MAAM,MAAO,QAAO,OAAO,aAAa,MAAM,KAAK;AACvD,WAAO,KAAK,oBAAoB,aAAa,MAAM,IAAI;AAAA,EACzD;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,UAAU,KAAK,oBAAoB,GAAG;AAC5C,UAAM,cAAc,IAAI,UAAU;AAClC,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,OAAO,IACd,EAAE,QAAQ,MAAM,QAAQ,QAAQ,IAChC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,OAAO,GAAG;AAAA,MAC1D;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AAGX,cAAI,CAAC,IAAI,UAAU,QAAQ;AACzB,mBAAO,EAAE,QAAQ,MAAM,QAAQ,yBAAyB;AAAA,UAC1D;AACA,gBAAM,MAAM,KAAK;AAAA,YACf;AAAA,UACF;AACA,gBAAM,SAAS,MAAM,YAAY;AACjC,cAAI,CAAC,OAAO,CAAC,QAAQ;AACnB,mBAAO,EAAE,QAAQ,QAAQ,QAAQ,MAAM,YAAY,OAAO,OAAO,GAAG;AAAA,UACtE;AACA,iBAAO,eAAe,SAClB,EAAE,QAAQ,MAAM,QAAQ,GAAG,YAAY,IAAI,WAAW,WAAW,IACjE;AAAA,YACE,QAAQ;AAAA,YACR,QAAQ,MAAM,YAAY,IAAI,WAAW,OAAO,OAAO;AAAA,UACzD;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,UAAU,IAAI,WAAW;AACtC,IAAO,cAAQ;","names":[]}

package/dist/{nemoclaw-3EVNKD3I.js → nemoclaw-CQYXZVQN.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   OpenClawAdapter
-} from "./chunk-KGGBNKI4.js";
+} from "./chunk-RQPKL62M.js";
 import "./chunk-DBQMX75U.js";
-import "./chunk-IW77FFNX.js";
+import "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-BXGFUENQ.js";
+import "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -55,4 +55,4 @@ export {
   adapter,
   nemoclaw_default as default
 };
-//# sourceMappingURL=nemoclaw-3EVNKD3I.js.map
+//# sourceMappingURL=nemoclaw-CQYXZVQN.js.map

package/dist/{omp-Z6FRNDPN.js → omp-2QMEY6HD.js}

@@ -4,12 +4,12 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-IW77FFNX.js";
+} from "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   shouldWrapForTelemetry
-} from "./chunk-BXGFUENQ.js";
+} from "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -63,8 +63,21 @@ var OMPAdapter = class extends BaseAdapter {
     canModifyOutput: false,
     // No session_start context-injection surface upstream.
     canInjectSessionContext: false,
-    // OMP registers stdio and remote (http) MCP servers.
-    transports: ["stdio", "http"]
+    // OMP registers stdio and remote (streamable http + sse) MCP servers.
+    transports: ["stdio", "sse", "http"],
+    // Action surface: each declared action becomes a user-invokable slash
+    // command registered INSIDE the generated plugin module (pi.registerCommand),
+    // shelling out to the home-bin `action` verb. supportsActions → the
+    // installActions/uninstallActions overrides below.
+    supportsActions: true,
+    // Native passthrough hooks: OMP's main-loop lifecycle events —
+    // agent_start, agent_end, turn_start, turn_end — have NO canonical
+    // HookEventName analog (verified in oh-my-pi shared-events.ts). A connector
+    // reaches them by declaring platforms["omp"].nativeHooks; the generated
+    // plugin registers + bridges each declared native event verbatim
+    // (buildPluginSource native loop), and the home-bin runtime dispatches it
+    // host-generically via runNativeHook.
+    supportsNativeHooks: true
   };
   // ── Native paths ───────────────────────────────────────────────────────
   /**
@@ -132,8 +145,17 @@ var OMPAdapter = class extends BaseAdapter {
         }
       ];
     }
+    const changes = [];
+    if (!this.capabilities.transports.includes(server.transport)) {
+      changes.push({
+        platform: this.id,
+        action: "warn",
+        path: serverPath,
+        detail: `transport "${server.transport}" is not an OMP MCP transport (stdio/sse/http); registered best-effort as type:"http"`
+      });
+    }
     const entry = this.renderServerEntry(ctx, server);
-    return [
+    changes.push(
       this.upsertServerInJson(
         serverPath,
         MCP_ROOT_KEY,
@@ -141,7 +163,8 @@ var OMPAdapter = class extends BaseAdapter {
         entry,
         ctx.dryRun
       )
-    ];
+    );
+    return changes;
   }
   uninstallServer(ctx) {
     const serverPath = this.getServerConfigPath(ctx);
@@ -165,8 +188,10 @@ var OMPAdapter = class extends BaseAdapter {
   /**
    * Render a normalized ServerDef into OMP's native "mcpServers" entry.
    *
-   * stdio  → { command, args, env }  (portable field names)
-   * remote → { url, headers? }
+   * stdio  → { command, args, env }  (portable field names; `type` omitted —
+   *          OMP defaults an entry with no `type` to stdio)
+   * remote → { type: "http"|"sse", url, headers? }  (`type` is REQUIRED for a
+   *          URL server — without it OMP would mis-parse the entry as stdio)
    *
    * Telemetry wrapping routes the real command through
    * `<homeBin> serve --connector <id> -- <command> <args...>`. OMP has no native
@@ -199,6 +224,7 @@ var OMPAdapter = class extends BaseAdapter {
       return entry2;
     }
     const entry = {
+      type: server.transport === "sse" ? "sse" : "http",
       url: resolveEnvRefsDeep(server.url ?? "")
     };
     const headers = this.renderEnv(server.headers);
@@ -213,7 +239,10 @@ var OMPAdapter = class extends BaseAdapter {
   // ── Hook install / uninstall (ts-plugin extension package) ──────────────
   installHooks(ctx) {
     const entryPath = this.getHookConfigPath(ctx);
-    if (ctx.connector.platforms[HOST]?.hooks === false) {
+    const nativeEvents = Object.keys(
+      ctx.connector.platforms[HOST]?.nativeHooks ?? {}
+    );
+    if (ctx.connector.platforms[HOST]?.hooks === false && nativeEvents.length === 0) {
       return [
         {
           platform: this.id,
@@ -223,16 +252,70 @@ var OMPAdapter = class extends BaseAdapter {
         }
       ];
     }
-    if (ctx.connector.hookEvents.length === 0) {
+    if (ctx.connector.hookEvents.length === 0 && nativeEvents.length === 0) {
       return [
         {
           platform: this.id,
           action: "skip",
           path: entryPath,
-          detail: "connector declares no hooks"
+          detail: this.actionTriggers(ctx).length > 0 ? "no hooks (plugin written for actions)" : "connector declares no hooks"
         }
       ];
     }
+    return this.ensurePlugin(
+      ctx,
+      (file) => file.path.endsWith("package.json") ? "omp extension manifest" : `omp plugin module (${this.hookDetail(ctx)})`
+    );
+  }
+  // ── Action install / uninstall (slash commands in the shared plugin) ────
+  /**
+   * Each declared action becomes a `pi.registerCommand(...)` inside the SAME
+   * generated extension module (see buildPluginSource). So installActions just
+   * ensures that shared module is on disk: when hooks already wrote the identical
+   * bytes the content-compare yields "skip" (no double material write), and an
+   * actions-only connector gets the plugin written here. Honors
+   * platforms.omp.actions === false and the empty-actions skip.
+   */
+  installActions(ctx) {
+    const entryPath = this.getHookConfigPath(ctx);
+    if (ctx.connector.platforms[HOST]?.actions === false) {
+      return [
+        { platform: this.id, action: "skip", path: entryPath, detail: "actions disabled for omp" }
+      ];
+    }
+    if (this.actionTriggers(ctx).length === 0) {
+      return [
+        { platform: this.id, action: "skip", path: entryPath, detail: "connector declares no actions" }
+      ];
+    }
+    return this.ensurePlugin(
+      ctx,
+      (file) => file.path.endsWith("package.json") ? "omp extension manifest" : "omp plugin module (action commands)"
+    );
+  }
+  /**
+   * Actions live INSIDE the shared plugin module, which uninstallHooks removes
+   * unconditionally (it runs last in the teardown pass). Removing it here too
+   * would race uninstallHooks, so this is a single informational skip.
+   */
+  uninstallActions(ctx) {
+    return [
+      {
+        platform: this.id,
+        action: "skip",
+        path: this.getHookConfigPath(ctx),
+        detail: "action commands are embedded in the plugin module; removed by uninstallHooks"
+      }
+    ];
+  }
+  /**
+   * Synthesize + content-compare-write the extension package (package.json +
+   * index.js). Shared by installHooks and installActions: the generator is a pure
+   * function of ctx, so whichever surface runs second sees byte-identical files
+   * and reports "skip" — no double material write. `detailFor` flavors the
+   * ChangeRecord detail per surface.
+   */
+  ensurePlugin(ctx, detailFor) {
     const files = this.synthesizePlugin(ctx);
     const changes = [];
     for (const file of files) {
@@ -250,7 +333,7 @@ var OMPAdapter = class extends BaseAdapter {
         platform: this.id,
         action,
         path: file.path,
-        detail: file.path.endsWith("package.json") ? "omp extension manifest" : `omp plugin module (${this.hookDetail(ctx)})`
+        detail: detailFor(file)
       });
     }
     return changes;
@@ -262,10 +345,18 @@ var OMPAdapter = class extends BaseAdapter {
    * "unsupported here" so the detail never overstates coverage.
    */
   hookDetail(ctx) {
-    const declared = ctx.connector.hookEvents;
+    const canonicalOff = ctx.connector.platforms[HOST]?.hooks === false;
+    const declared = canonicalOff ? [] : ctx.connector.hookEvents;
     const mapped = declared.filter((e) => EVENT_TO_OMP[e] !== void 0);
     const unsupported = declared.filter((e) => EVENT_TO_OMP[e] === void 0);
-    const base = mapped.join(",");
+    const nativeEvents = Object.keys(
+      ctx.connector.platforms[HOST]?.nativeHooks ?? {}
+    );
+    const parts = [mapped.join(",")].filter((p) => p !== "");
+    if (nativeEvents.length > 0) {
+      parts.push(`native: ${nativeEvents.join(",")}`);
+    }
+    const base = parts.join("; ");
     return unsupported.length > 0 ? `${base}; unsupported here: ${unsupported.join(",")}` : base;
   }
   uninstallHooks(ctx) {
@@ -342,7 +433,8 @@ var OMPAdapter = class extends BaseAdapter {
   buildPluginSource(ctx) {
     const homeBin = JSON.stringify(ctx.homeBinPath);
     const connectorId = JSON.stringify(ctx.connector.id);
-    const events = ctx.connector.hookEvents.filter(
+    const canonicalOff = ctx.connector.platforms[HOST]?.hooks === false;
+    const events = canonicalOff ? [] : ctx.connector.hookEvents.filter(
       (e) => EVENT_TO_OMP[e] !== void 0
     );
     const has = (e) => events.includes(e);
@@ -461,11 +553,39 @@ function deriveSessionId(ctx) {
   pi.on("session_before_compact", () => {
     bridge("PreCompact", { sessionId: SESSION_ID, projectDir: PROJECT_DIR });
     return undefined;
+  });`);
+    }
+    const nativeEvents = Object.keys(
+      ctx.connector.platforms[HOST]?.nativeHooks ?? {}
+    );
+    for (const ev of nativeEvents) {
+      handlers.push(`  // nativeHooks passthrough \u2192 ${ev}
+  pi.on(${JSON.stringify(ev)}, (event) => {
+    bridge(${JSON.stringify(ev)}, { sessionId: SESSION_ID, projectDir: PROJECT_DIR, raw: event });
+    return undefined;
+  });`);
+    }
+    const actionHandlers = [];
+    for (const action of this.actionTriggers(ctx)) {
+      const id = JSON.stringify(action.id);
+      const description = JSON.stringify(action.description);
+      actionHandlers.push(`  // Action /${action.id} \u2192 run the home-bin action verb directly.
+  pi.registerCommand(${id}, {
+    description: ${description},
+    handler: async (_args, _ctx) => {
+      try {
+        const args = ["action", "omp", ${id}, "--connector", CONNECTOR_ID];
+        process.platform === "win32"
+          ? execSync([HOME_BIN, ...args].map((a) => '"' + a + '"').join(" "), { stdio: "inherit" })
+          : execFileSync(HOME_BIN, args, { stdio: "inherit" });
+      } catch { /* fail-open */ }
+      return undefined;
+    },
   });`);
     }
     const factory = `
 export default function plugin(pi) {
-${handlers.join("\n\n")}
+${[...handlers, ...actionHandlers].join("\n\n")}
 }
 `;
     return header + factory;
@@ -535,7 +655,7 @@ ${handlers.join("\n\n")}
     const entryPath = this.getHookConfigPath(ctx);
     const manifestPath = join(this.extensionDir(ctx), "package.json");
     const connectorId = ctx.connector.id;
-    const hasHooks = ctx.connector.hookEvents.length > 0;
+    const hasHooks = ctx.connector.hookEvents.length > 0 || this.actionTriggers(ctx).length > 0;
     return [
       {
         name: `${this.name}: mcp.json present`,
@@ -594,4 +714,4 @@ export {
   adapter,
   omp_default as default
 };
-//# sourceMappingURL=omp-Z6FRNDPN.js.map
+//# sourceMappingURL=omp-2QMEY6HD.js.map