@modootoday/pmcp 0.15.0 → 0.16.1

package/dist/{embed-CVCEz2FH.d.ts → embed-DRROSD3F.d.ts}

@@ -1,4 +1,4 @@
-import { E as Embedder } from './server-DAcT89iv.js';
+import { E as Embedder } from './server-VWSY3Shw.js';
 import { E as EncoderOptions } from './encoder-DGRy9skC.js';
 
 /**

package/dist/http.d.ts

@@ -1,6 +1,7 @@
-import { S as SkillServerOptions, E as Embedder, a as SkillEntry } from './server-DAcT89iv.js';
-import { L as LoadEmbedderOptions } from './embed-CVCEz2FH.js';
-export { l as loadEmbedder } from './embed-CVCEz2FH.js';
+import { S as SkillServerOptions, E as Embedder, a as SkillEntry } from './server-VWSY3Shw.js';
+export { C as CatalogOptions, R as Runtime, r as readCatalog, v as verifiedRuntimesOf } from './server-VWSY3Shw.js';
+import { L as LoadEmbedderOptions } from './embed-DRROSD3F.js';
+export { l as loadEmbedder } from './embed-DRROSD3F.js';
 import { M as MailboxService } from './service-qpCsOXkQ.js';
 export { D as DEFAULT_MODEL_ID } from './encoder-DGRy9skC.js';
 import 'zod';
@@ -80,4 +81,4 @@ interface SkillHttpHandler {
 }
 declare function createSkillHttpHandler(options: SkillHttpOptions): SkillHttpHandler;
 
-export { DEFAULT_MAX_REQUEST_BYTES, DEFAULT_TIERS, Embedder, type RateLimitOptions, type SkillCaller, type SkillHttpHandler, type SkillHttpOptions, type SkillHttpSemanticOptions, createSkillHttpHandler, visibleTo };
+export { DEFAULT_MAX_REQUEST_BYTES, DEFAULT_TIERS, Embedder, type RateLimitOptions, type SkillCaller, SkillEntry, type SkillHttpHandler, type SkillHttpOptions, type SkillHttpSemanticOptions, createSkillHttpHandler, visibleTo };

package/dist/http.js

@@ -694,7 +694,7 @@ function withoutBody({
 
 // src/intent.ts
 function normaliseIntent(intent) {
-  return intent.toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
+  return intent.normalize("NFC").toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
 }
 
 // src/embed.ts
@@ -2294,7 +2294,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.15.0";
+var SERVER_VERSION = "0.16.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);
@@ -2426,6 +2426,8 @@ export {
   DEFAULT_TIERS,
   createSkillHttpHandler,
   loadEmbedder,
+  readCatalog,
+  verifiedRuntimesOf,
   visibleTo
 };
 //# sourceMappingURL=http.js.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { I as IntentCache, R as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, b as SkillTools } from './server-DAcT89iv.js';
-export { A as ASSET_KINDS, c as AssetKind, B as BundleFile, d as CATALOG_PAGE_MAX, e as CATALOG_PAGE_SIZE, f as COMPATIBILITY_MAX, g as CallResponse, h as CatalogItem, i as CatalogResponse, j as Classified, D as DEFAULT_FIND_LIMIT, k as DESCRIBE_FILE_LIMIT, l as DESCRIPTION_MAX, F as FileKind, m as FindOptions, n as FindResult, o as IntentCacheStats, K as KindFilter, p as MAX_SKILL_DEPTH, q as Match, r as MetadataLeaf, N as NAME_MAX, s as READ_BUDGET_BYTES, t as RUNTIMES, u as ReadResult, v as Runtime, w as SKIPPED_DIRS, x as SkillBundle, y as SkillFile, z as SkillFileContent, G as SkillFileListing, H as SkillFilters, J as bundleResponseSchema, L as bundleSkill, O as catalogResponseSchema, P as classify, Q as cosine, T as createSkillTools, U as describeResponseSchema, V as detectRuntime, W as displayPath, X as find, Y as findResultSchema, Z as isUtf8Text, _ as kindOf, $ as lexicalScore, a0 as listSkillFiles, a1 as mimeOf, a2 as normaliseIntent, a3 as parseSkillFrontmatter, a4 as readBody, a5 as readCatalog, a6 as readFrontmatter, a7 as readSkillFile, a8 as runtimeOfClient, a9 as specProblems, aa as verifiedRuntimesOf, ab as withoutBody } from './server-DAcT89iv.js';
-import { L as LoadEmbedderOptions } from './embed-CVCEz2FH.js';
-export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-CVCEz2FH.js';
+import { I as IntentCache, b as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, c as SkillTools } from './server-VWSY3Shw.js';
+export { A as ASSET_KINDS, d as AssetKind, B as BundleFile, e as CATALOG_PAGE_MAX, f as CATALOG_PAGE_SIZE, g as COMPATIBILITY_MAX, h as CallResponse, i as CatalogItem, j as CatalogResponse, k as Classified, D as DEFAULT_FIND_LIMIT, l as DESCRIBE_FILE_LIMIT, m as DESCRIPTION_MAX, F as FileKind, n as FindOptions, o as FindResult, p as IntentCacheStats, K as KindFilter, q as MAX_SKILL_DEPTH, s as Match, t as MetadataLeaf, N as NAME_MAX, u as READ_BUDGET_BYTES, w as RUNTIMES, x as ReadResult, R as Runtime, y as SKIPPED_DIRS, z as SkillBundle, G as SkillFile, H as SkillFileContent, J as SkillFileListing, L as SkillFilters, O as bundleResponseSchema, P as bundleSkill, Q as catalogResponseSchema, T as classify, U as cosine, V as createSkillTools, W as describeResponseSchema, X as detectRuntime, Y as displayPath, Z as find, _ as findResultSchema, $ as isUtf8Text, a0 as kindOf, a1 as lexicalScore, a2 as listSkillFiles, a3 as mimeOf, a4 as normaliseIntent, a5 as parseSkillFrontmatter, a6 as readBody, r as readCatalog, a7 as readFrontmatter, a8 as readSkillFile, a9 as runtimeOfClient, aa as specProblems, v as verifiedRuntimesOf, ab as withoutBody } from './server-VWSY3Shw.js';
+import { L as LoadEmbedderOptions } from './embed-DRROSD3F.js';
+export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-DRROSD3F.js';
 export { D as DEFAULT_MODEL_ID, a as EmbeddingModel, b as EncoderDtype, E as EncoderOptions, c as EncoderSpec, R as ResolvedEncoder, e as embeddingModels, d as encoderSpec, r as resolveEncoder } from './encoder-DGRy9skC.js';
 import { P as ProjectConfig } from './config-BkSpjUG6.js';
 export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-BkSpjUG6.js';
@@ -275,7 +275,7 @@ declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]
 
 /** Reported to the host on connect. */
 declare const SERVER_NAME = "pmcp";
-declare const SERVER_VERSION = "0.15.0";
+declare const SERVER_VERSION = "0.16.1";
 /**
  * Registers the skill_* tools on a server.
  *

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/intent.ts
 function normaliseIntent(intent) {
-  return intent.toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
+  return intent.normalize("NFC").toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
 }
 
 // src/storage/sqlite.ts
@@ -4679,7 +4679,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.15.0";
+var SERVER_VERSION = "0.16.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/{server-DAcT89iv.d.ts → server-VWSY3Shw.d.ts}

@@ -144,8 +144,7 @@ interface IntentCache {
     close(): void;
 }
 /**
- * Same question, differently typed. Case, punctuation and spacing only — the
- * key has to survive a caller writing "How do I wire X?" and "how do i wire x".
+ * Canonically equivalent Unicode must share the same query and cache key.
  */
 declare function normaliseIntent(intent: string): string;
 
@@ -541,4 +540,4 @@ declare function createSkillTools(options: SkillServerOptions): {
 };
 type SkillTools = ReturnType<typeof createSkillTools>;
 
-export { lexicalScore as $, ASSET_KINDS as A, type BundleFile as B, type CatalogOptions as C, DEFAULT_FIND_LIMIT as D, type Embedder as E, type FileKind as F, type SkillFileListing as G, type SkillFilters as H, type IntentCache as I, bundleResponseSchema as J, type KindFilter as K, bundleSkill as L, type MetadataValue as M, NAME_MAX as N, catalogResponseSchema as O, classify as P, cosine as Q, type Ranking as R, type SkillServerOptions as S, createSkillTools as T, describeResponseSchema as U, detectRuntime as V, displayPath as W, find as X, findResultSchema as Y, isUtf8Text as Z, kindOf as _, type SkillEntry as a, listSkillFiles as a0, mimeOf as a1, normaliseIntent as a2, frontmatterObject as a3, readBody as a4, readCatalog as a5, readFrontmatter as a6, readSkillFile as a7, runtimeOfClient as a8, specProblems as a9, verifiedRuntimesOf as aa, withoutBody as ab, type SkillTools as b, type AssetKind as c, CATALOG_PAGE_MAX as d, CATALOG_PAGE_SIZE as e, COMPATIBILITY_MAX as f, type CallResponse as g, type CatalogItem as h, type CatalogResponse as i, type Classified as j, DESCRIBE_FILE_LIMIT as k, DESCRIPTION_MAX as l, type FindOptions as m, type FindResult as n, type IntentCacheStats as o, MAX_SKILL_DEPTH as p, type Match as q, type MetadataLeaf as r, READ_BUDGET_BYTES as s, RUNTIMES as t, type ReadResult as u, type Runtime as v, SKIPPED_DIRS as w, type SkillBundle as x, type SkillFile as y, type SkillFileContent as z };
+export { isUtf8Text as $, ASSET_KINDS as A, type BundleFile as B, type CatalogOptions as C, DEFAULT_FIND_LIMIT as D, type Embedder as E, type FileKind as F, type SkillFile as G, type SkillFileContent as H, type IntentCache as I, type SkillFileListing as J, type KindFilter as K, type SkillFilters as L, type MetadataValue as M, NAME_MAX as N, bundleResponseSchema as O, bundleSkill as P, catalogResponseSchema as Q, type Runtime as R, type SkillServerOptions as S, classify as T, cosine as U, createSkillTools as V, describeResponseSchema as W, detectRuntime as X, displayPath as Y, find as Z, findResultSchema as _, type SkillEntry as a, kindOf as a0, lexicalScore as a1, listSkillFiles as a2, mimeOf as a3, normaliseIntent as a4, frontmatterObject as a5, readBody as a6, readFrontmatter as a7, readSkillFile as a8, runtimeOfClient as a9, specProblems as aa, withoutBody as ab, type Ranking as b, type SkillTools as c, type AssetKind as d, CATALOG_PAGE_MAX as e, CATALOG_PAGE_SIZE as f, COMPATIBILITY_MAX as g, type CallResponse as h, type CatalogItem as i, type CatalogResponse as j, type Classified as k, DESCRIBE_FILE_LIMIT as l, DESCRIPTION_MAX as m, type FindOptions as n, type FindResult as o, type IntentCacheStats as p, MAX_SKILL_DEPTH as q, readCatalog as r, type Match as s, type MetadataLeaf as t, READ_BUDGET_BYTES as u, verifiedRuntimesOf as v, RUNTIMES as w, type ReadResult as x, SKIPPED_DIRS as y, type SkillBundle as z };

package/dist/stdio.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { serveStdio } from '@modelcontextprotocol/server/stdio';
-import { S as SkillServerOptions, C as CatalogOptions } from './server-DAcT89iv.js';
+import { S as SkillServerOptions, C as CatalogOptions } from './server-VWSY3Shw.js';
 import { M as MailboxService } from './service-qpCsOXkQ.js';
 import { M as MailboxAttachmentOptions } from './attachment-tU5FZrgZ.js';
 import 'zod';

package/dist/stdio.js

@@ -1050,7 +1050,7 @@ import { createHash as createHash2 } from "crypto";
 
 // src/intent.ts
 function normaliseIntent(intent) {
-  return intent.toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
+  return intent.normalize("NFC").toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
 }
 
 // src/find.ts
@@ -1941,7 +1941,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.15.0";
+var SERVER_VERSION = "0.16.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/tui-worker.js

@@ -64,6 +64,11 @@ var tuiOptions = [
   },
   { name: "rows", describe: "Terminal rows (12\u20131000)", placeholder: "<count>" },
   { name: "index", describe: "Worker dock index", placeholder: "<count>" },
+  {
+    name: "memory-mb",
+    describe: "Worker memory reservation",
+    placeholder: "<count>"
+  },
   {
     name: "confirm-session",
     describe: "Exact target ID for stop",
@@ -76,7 +81,7 @@ var tuiOptions = [
   },
   {
     name: "runtime",
-    describe: "Main native runtime ID for launch",
+    describe: "Native runtime ID for main launch or worker start",
     placeholder: "<runtime>"
   },
   {
@@ -98,6 +103,8 @@ var tuiOptions = [
 var allowed = {
   launch: ["config", "runtime", "yes", "new"],
   plan: ["config", "runtime"],
+  recovery: ["config"],
+  "start-worker": ["config", "view", "runtime", "memory-mb"],
   doctor: [],
   create: ["group-file", "columns", "rows", "config", "actor-file"],
   inspect: ["view"],
@@ -115,6 +122,7 @@ var allowed = {
   close: ["view"],
   dismiss: ["view"],
   management: ["view"],
+  "worker-menu": ["view"],
   check: ["view"]
 };
 function parseTui(args) {
@@ -139,7 +147,23 @@ function parseTui(args) {
     return Number(value);
   };
   if (action === "doctor") return { action, input: {} };
-  if (action === "launch" || action === "plan")
+  if (action === "start-worker") {
+    const config = one(args, "config");
+    const viewFile = one(args, "view");
+    if (config && viewFile)
+      throw new ArgumentError("Choose --config or --view for worker start");
+    return {
+      action,
+      viewFile,
+      input: {},
+      startup: {
+        config,
+        runtime: required("runtime"),
+        memoryMb: number("memory-mb")
+      }
+    };
+  }
+  if (action === "launch" || action === "plan" || action === "recovery")
     return {
       action,
       input: {},
@@ -3427,13 +3451,19 @@ var CommonHarness = class {
 // src/tui/application/feedback.ts
 import { join as join20 } from "path";
 var hints = {
-  startup_requires_recovery: "Inspect the saved group with pmcp tui plan and pmcp harness recovery inspect. No runtime was restarted.",
+  startup_requires_recovery: "Run pmcp tui recovery for saved ownership and exact inspection commands. No runtime was restarted.",
   startup_group_paused: "The saved group is paused. Resume it explicitly through the harness CLI before reopening.",
   startup_main_unavailable: "Inspect the saved main and recovery state. Stop the old group explicitly before using pmcp tui --new.",
   startup_busy: "Another workspace launch is running. Wait and retry.",
   startup_runtime_conflict: "The saved main uses another runtime. Stop the old group before creating a new workspace.",
   workspace_already_running: "Reopen the existing workspace, or stop its exact owned group before using --new.",
   runtime_executable_unavailable: "Install the selected native CLI on PATH, or choose an installed runtime with --runtime.",
+  view_client_unavailable: "Open the view before using the worker menu, or run pmcp tui start-worker with --view and --runtime.",
+  runtime_not_granted: "Choose a runtime granted by this owned group. Inspect the group before creating another workspace.",
+  runtime_capacity_exceeded: "Stop an exact owned worker before adding another, or use the main session alone.",
+  aggregate_memory_budget_exceeded: "Use fewer sessions or start a worker with an explicit smaller --memory-mb reservation.",
+  group_not_ready: "Inspect the group and resume a paused group explicitly before adding a worker.",
+  startup_group_not_ready: "Inspect the group and resume a paused group explicitly before adding a worker.",
   control_connection_lost: "The native writer or lease disappeared. Inspect and release control before reconnecting.",
   control_busy: "Another controller holds the lease. Release it explicitly before retrying.",
   native_writer_active: "A native writer is still attached. Detach that writer before retrying.",
@@ -3489,6 +3519,14 @@ function phaseLabel(phase2) {
   return labels[phase2];
 }
 
+// src/tui/presentation/target.ts
+function targetStatus(view) {
+  const role2 = view.target === view.mainId ? "MAIN" : "WORKER";
+  const phase2 = view.phase === "read-only" ? "OBSERVE" : phaseLabel(view.phase);
+  const input = view.phase === "controlled" ? "INPUT ON" : "INPUT OFF";
+  return `${role2} ${view.target.slice(0, 8)} | ${phase2} | ${input}`;
+}
+
 // src/tui/adapters/tmux/connection.ts
 import { spawn as spawn2 } from "child_process";
 import { join as join21 } from "path";
@@ -3642,7 +3680,8 @@ function bindKeys(connection, view, file) {
     ["b", "mailbox"],
     ["d", "detach"],
     ["!", "dismiss"],
-    ["g", "management"]
+    ["g", "management"],
+    ["n", "worker-menu"]
   ])
     connection.command([
       "bind-key",
@@ -3663,7 +3702,7 @@ function bindKeys(connection, view, file) {
     "bind-key",
     "?",
     "display-message",
-    "m main; w/1-4 worker; c control; r release; h history; b mailbox; d detach; ! dismiss error; double Ctrl-g forwards native Ctrl-g"
+    "m main; n add worker; w/1-4 worker; c control; r release; h history; b mailbox; d detach; ! dismiss error; double Ctrl-g forwards native Ctrl-g"
   ]);
   connection.command([
     "set-hook",
@@ -3863,7 +3902,7 @@ var TmuxView = class {
       "set-option",
       "-g",
       "status-right",
-      `${view.target === view.mainId ? "main" : "worker"} | ${phaseLabel(view.phase)}${failure2} | Ctrl-g ?`
+      `${targetStatus(view)}${failure2} | Ctrl-g ?`
     ]);
   }
   input(pane, enabled) {
@@ -3886,6 +3925,32 @@ var TmuxView = class {
   clients() {
     return this.connection.command(["list-clients", "-F", "#{client_pid}"]);
   }
+  workerMenu(view) {
+    const pane = view.workerPane ?? view.mainPane;
+    this.connection.assertOwned(pane);
+    const popup = [
+      "tmux",
+      "-S",
+      this.connection.socket,
+      "display-popup",
+      "-E",
+      "-t",
+      pane,
+      "-w",
+      "90%",
+      "-h",
+      "80%",
+      this.shell([
+        view.node,
+        view.worker,
+        "worker-menu",
+        "--view",
+        this.stateFile,
+        "--callback"
+      ])
+    ];
+    this.connection.command(["run-shell", "-b", popup.map(quote).join(" ")]);
+  }
   copy(pane) {
     this.connection.assertOwned(pane);
     this.connection.command(["copy-mode", "-t", pane]);
@@ -3952,6 +4017,7 @@ function dockLines(snapshot) {
     ),
     "",
     "Ctrl-g w: observe worker",
+    "Ctrl-g n: add worker",
     "Ctrl-g m: return to main",
     "Ctrl-g c: acquire control",
     "Ctrl-g r: release control",
@@ -3963,7 +4029,7 @@ function dockLines(snapshot) {
   ];
 }
 function coordinationLines(snapshot, view) {
-  const target = `TARGET ${view.target === view.mainId ? "main" : "worker"} ${safe(view.target.slice(0, 8))} / ${phaseLabel(view.phase)}`;
+  const target = `TARGET ${safe(targetStatus(view))}`;
   if (view.failure)
     return [
       target,
@@ -5717,6 +5783,11 @@ var handlers = {
   close: closeView,
   check: checkControl,
   dismiss: ({ view, file }) => dismissFailure(file, view),
+  "worker-menu": async (context) => {
+    if (!context.renderer.clients()) throw new Error("view_client_unavailable");
+    await releaseControl(context);
+    context.renderer.workerMenu(context.view);
+  },
   management: async (context) => {
     await releaseControl(context);
     if (context.view.managementWindow) {
@@ -5850,6 +5921,70 @@ function runtime() {
   return { node: realpathSync10(available.node), worker: bundled };
 }
 
+// src/tui/startup/diagnostics.ts
+function remediation(tools, userManagerAvailable) {
+  const steps = [];
+  if (tools.platform !== "linux")
+    steps.push(
+      "Use a qualified Linux host for the terminal workspace. Other PMCP CLI features do not require this host profile."
+    );
+  const missing = ["tmux", "flock", "systemctl", "systemdRun"].filter(
+    (name) => !tools[name]
+  );
+  if (missing.length)
+    steps.push(
+      `Install the missing tmux, util-linux or systemd tools for your distribution and add them to PATH: ${missing.join(", ")}.`
+    );
+  if (!tools.nodeSupported)
+    steps.push(
+      "Select Node.js 22 or later through your existing version manager and check node --version in this terminal."
+    );
+  if (tools.supported && !userManagerAvailable)
+    steps.push(
+      "Check systemctl --user status in your login session and restore access to its user manager before launching. Doctor does not start or repair services."
+    );
+  return steps;
+}
+function inspectTerminalHost() {
+  const tools = dependencies();
+  let userManagerAvailable = false;
+  let reason;
+  try {
+    if (!tools.supported) throw new Error("tui_dependencies_unavailable");
+    assertNativeHost();
+    userManagerAvailable = true;
+  } catch (error) {
+    reason = error instanceof Error ? error.message : "native_host_unavailable";
+  }
+  const runtimes = Object.entries(runtimeExecutables).map(
+    ([id2, executable]) => {
+      const path = locateExecutable(executable);
+      return {
+        id: id2,
+        executable,
+        installed: Boolean(path),
+        ...path ? { path } : {},
+        nativeAcceptance: "not-assessed",
+        authentication: "not-inspected"
+      };
+    }
+  );
+  return {
+    schemaVersion: 1,
+    ok: true,
+    ...tools,
+    supported: tools.supported && userManagerAvailable,
+    userManagerAvailable,
+    ...reason ? { reason } : {},
+    runtimes,
+    qualification: "Prerequisite availability only; native behavior and cgroup delegation require separate qualification.",
+    remediation: remediation(tools, userManagerAvailable),
+    nextCommands: ["pmcp tui plan", "pmcp tui recovery"],
+    providerInvoked: false,
+    authenticationInspected: false
+  };
+}
+
 // src/tui/application/create.ts
 import { join as join29 } from "path";
 import { realpathSync as realpathSync11 } from "fs";
@@ -5928,10 +6063,9 @@ async function createView(input) {
 
 // src/tui/application/invoke.ts
 async function invokeTui(invocation) {
-  if (invocation.action === "launch" || invocation.action === "plan")
+  if (["launch", "plan", "recovery", "start-worker"].includes(invocation.action))
     throw new Error("startup_requires_cli_context");
-  if (invocation.action === "doctor")
-    return { schemaVersion: 1, ok: true, ...dependencies() };
+  if (invocation.action === "doctor") return inspectTerminalHost();
   if (invocation.action === "create") return createView(invocation.create);
   if (invocation.action === "inspect")
     return operate("inspect", invocation.viewFile);
@@ -6206,6 +6340,115 @@ function assertGroup(group, projectRoot, generation) {
     throw new Error("stale_group_generation");
 }
 
+// src/tui/application/worker-start.ts
+async function startViewWorker(file, runtime2, memoryMb) {
+  const { view, common } = openView(file);
+  if (view.state !== "open") throw new Error("view_closed");
+  const observed = await common.snapshot();
+  if (observed.group.state !== "ready") throw new Error("group_not_ready");
+  const main = observed.sessions.find(
+    (session) => session.id === view.mainId && session.role === "main"
+  );
+  if (!main?.alive) throw new Error("startup_main_unavailable");
+  return common.call("session", "start", {
+    input: { role: "worker", runtime: runtime2, memoryMb: memoryMb ?? main.memoryMb }
+  });
+}
+
+// src/cli/entry.ts
+function interactiveEntry(terminal) {
+  if (!terminal.stdin || !terminal.stdout) return false;
+  if (!terminal.term || terminal.term === "dumb") return false;
+  return !terminal.ci || terminal.ci === "false" || terminal.ci === "0";
+}
+
+// src/tui/startup/host.ts
+function terminalSupport() {
+  try {
+    if (!dependencies().supported)
+      throw new Error("tui_dependencies_unavailable");
+    assertNativeHost();
+    planLayout(process.stdout.columns ?? 0, process.stdout.rows ?? 0);
+    return { supported: true };
+  } catch (error) {
+    return {
+      supported: false,
+      reason: error instanceof Error ? error.message : "terminal_unavailable"
+    };
+  }
+}
+function requireTerminal() {
+  if (!interactiveEntry({
+    stdin: process.stdin.isTTY === true,
+    stdout: process.stdout.isTTY === true,
+    term: process.env.TERM,
+    ci: process.env.CI
+  }))
+    throw new Error("terminal_required");
+  const support = terminalSupport();
+  if (!support.supported) throw new Error(support.reason);
+}
+
+// src/tui/presentation/runtime-choice.ts
+import { createInterface } from "readline/promises";
+async function chooseRuntime(prompt, choices, preferred) {
+  if (!choices.length) throw new Error("runtime_executable_unavailable");
+  const fallback = Math.max(choices.indexOf(preferred), 0);
+  process.stderr.write(
+    `${choices.map((runtime2, index) => `${index + 1}. ${runtime2}`).join("\n")}
+`
+  );
+  while (true) {
+    const answer = (await prompt.question(
+      `Runtime [1-${choices.length}, Enter=${fallback + 1}, q=cancel] `
+    )).trim();
+    if (answer === "q") return void 0;
+    if (answer === "") return choices[fallback];
+    if (!/^\d+$/.test(answer)) continue;
+    const index = Number(answer) - 1;
+    if (Number.isSafeInteger(index) && index >= 0 && index < choices.length)
+      return choices[index];
+  }
+}
+async function confirmRuntimeStart(prompt, runtime2) {
+  const answer = await prompt.question(
+    `Start ${runtime2}? [Enter=start, q=cancel] `
+  );
+  return answer.trim() === "";
+}
+function terminalPrompt() {
+  return createInterface({ input: process.stdin, output: process.stderr });
+}
+
+// src/tui/presentation/worker-menu.ts
+async function runWorkerMenu(file) {
+  requireTerminal();
+  const { view, common } = openView(file);
+  if (view.state !== "open") throw new Error("view_closed");
+  const observed = await common.snapshot();
+  const group = observed.group;
+  if (group.state !== "ready") throw new Error("startup_group_not_ready");
+  const choices = group.allowedRuntimes.filter((runtime2) => {
+    const executable = runtimeExecutables[runtime2];
+    if (!executable) return false;
+    if (group.profile === "docker")
+      return Boolean(group.dockerPolicy?.commands[runtime2]);
+    return Boolean(locateExecutable(executable, group.projectRoot));
+  });
+  const main = observed.sessions.find((session) => session.id === view.mainId);
+  if (!main?.alive) throw new Error("startup_main_unavailable");
+  process.stderr.write(`PMCP WORKER | ${group.projectRoot}
+`);
+  const prompt = terminalPrompt();
+  try {
+    const runtime2 = await chooseRuntime(prompt, choices, main.runtime);
+    if (!runtime2 || !await confirmRuntimeStart(prompt, runtime2)) return;
+    await startViewWorker(file, runtime2);
+  } finally {
+    prompt.close();
+  }
+}
+
 // src/tui/application/worker.ts
 var [role, ...argv] = process.argv.slice(2);
 var callback2 = argv.includes("--callback");
@@ -6222,6 +6465,14 @@ try {
     const result = await prepareWorkspace(request2);
     process.stdout.write(`${JSON.stringify(result)}
 `);
+  } else if (role === "worker-menu") {
+    const invocation = parseTui(
+      parseArgs(
+        ["worker-menu", ...argv.filter((arg) => arg !== "--callback")],
+        tuiOptions
+      )
+    );
+    await runWorkerMenu(invocation.viewFile);
   } else if (role === "attach") {
     const [file, sessionId, leaseFile] = argv;
     if (!file || !sessionId) throw new Error("invalid_attachment_arguments");
@@ -6254,7 +6505,14 @@ try {
         tuiOptions
       )
     );
-    if (["create", "doctor", "launch", "plan"].includes(invocation.action))
+    if ([
+      "create",
+      "doctor",
+      "launch",
+      "plan",
+      "recovery",
+      "start-worker"
+    ].includes(invocation.action))
       throw new Error("unsupported_worker_operation");
     const result = role === "locked" ? await operate(
       invocation.action,
@@ -6273,7 +6531,8 @@ try {
     const file = argv[index + 1];
     if (index >= 0 && file) {
       try {
-        recordCallbackFailure(file, argv[0] ?? "callback", error);
+        const action = role === "worker-menu" ? role : argv[0] ?? "callback";
+        recordCallbackFailure(file, action, error);
         const { view } = readView(file);
         if (view.state === "open") new TmuxView(view, file).status(view);
       } catch {

package/docs/hosting.md

@@ -26,6 +26,19 @@ const skills = createSkillHttpHandler({
 export default { fetch: (request: Request) => skills.fetch(request) };
 ```
 
+Import `readCatalog` and `verifiedRuntimesOf` from the same `/http` entry when
+the host also displays the catalog. `verifiedRuntimesOf(metadata)` accepts an
+array or a comma/whitespace-separated string, drops unknown names and removes
+duplicates while preserving declaration order. Hosts that need a fixed display
+order can sort the result themselves.
+
+Pass `onReject: ({ path, reason }) => reportRejectedCatalog(path, reason)` to
+observe rejected marketplace entries during startup and `reload()`. This callback
+is synchronous and reports only the path and reason. A custom `loadCatalog` must
+forward its options to `readCatalog` to retain rejection reporting. If the host
+loads a separate site catalog, pass the callback to that load as well. Deduplicate
+repeated warnings in the host and keep local paths out of public responses.
+
 The handler checks requests before they reach MCP:
 
 | Option            | Default | Effect                                                                                                                                                                                                                                  |