@modootoday/pmcp 0.15.0 → 0.16.0

package/dist/harness-launch-gate.js

@@ -546,7 +546,6 @@ var Connection = class {
   constructor(records3) {
     this.records = records3;
   }
-  records;
   tmux(args, options = {}) {
     return command(
       "tmux",
@@ -693,8 +692,6 @@ var LaunchJournal = class {
     this.id = id2;
     runtimeUnit(id2);
   }
-  records;
-  id;
   path(kind) {
     if (!["intent", "proof", "grant", "committed", "aborted"].includes(kind))
       throw new Error("invalid_launch_artifact");

package/dist/harness-worker.js

@@ -453,7 +453,6 @@ var Connection = class {
   constructor(records2) {
     this.records = records2;
   }
-  records;
   tmux(args, options = {}) {
     return command(
       "tmux",
@@ -706,8 +705,6 @@ var LaunchJournal = class {
     this.id = id2;
     runtimeUnit(id2);
   }
-  records;
-  id;
   path(kind) {
     if (!["intent", "proof", "grant", "committed", "aborted"].includes(kind))
       throw new Error("invalid_launch_artifact");
@@ -1794,7 +1791,6 @@ var Backend = class {
     this.runDirectory = recordStore.directory;
     this.metadataPath = recordStore.metadataPath;
   }
-  recordStore;
   connection;
   owner;
   socket;

package/dist/http.js

@@ -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.0";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/index.d.ts

@@ -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.0";
 /**
  * Registers the skill_* tools on a server.
  *

package/dist/index.js

@@ -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.0";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/mailbox/index.js

@@ -144,8 +144,6 @@ var MailboxError = class extends Error {
     this.retryable = retryable;
     this.name = "MailboxError";
   }
-  code;
-  retryable;
 };
 function failure(error) {
   if (error instanceof MailboxError) {
@@ -1091,7 +1089,6 @@ var NotificationOutbox = class {
   constructor(store) {
     this.store = store;
   }
-  store;
   discover(binding, nativeTarget) {
     return this.store.run(() => {
       this.store.assertBinding(binding);

package/dist/stdio.js

@@ -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.0";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);
@@ -2003,8 +2003,6 @@ var MailboxError = class extends Error {
     this.retryable = retryable;
     this.name = "MailboxError";
   }
-  code;
-  retryable;
 };
 function failure(error) {
   if (error instanceof MailboxError) {

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: {},
@@ -887,7 +911,6 @@ var Connection = class {
   constructor(records2) {
     this.records = records2;
   }
-  records;
   tmux(args, options = {}) {
     return command(
       "tmux",
@@ -1124,8 +1147,6 @@ var LaunchJournal = class {
     this.id = id2;
     runtimeUnit(id2);
   }
-  records;
-  id;
   path(kind) {
     if (!["intent", "proof", "grant", "committed", "aborted"].includes(kind))
       throw new Error("invalid_launch_artifact");
@@ -2254,7 +2275,6 @@ var Backend = class {
     this.runDirectory = recordStore.directory;
     this.metadataPath = recordStore.metadataPath;
   }
-  recordStore;
   connection;
   owner;
   socket;
@@ -3393,7 +3413,6 @@ var CommonHarness = class {
   constructor(view) {
     this.view = view;
   }
-  view;
   async call(family, action, input = {}) {
     const group = new GroupStore(this.view.groupFile).state.group;
     if (group.owner !== this.view.groupOwner) throw new Error("foreign_group");
@@ -3427,13 +3446,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 +3514,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";
@@ -3537,9 +3570,6 @@ var ViewConnection = class {
     this.identity = identity;
     this.socket = join21(directory, "s");
   }
-  directory;
-  owner;
-  identity;
   socket;
   raw(args) {
     const env = { ...process.env };
@@ -3642,7 +3672,8 @@ function bindKeys(connection, view, file) {
     ["b", "mailbox"],
     ["d", "detach"],
     ["!", "dismiss"],
-    ["g", "management"]
+    ["g", "management"],
+    ["n", "worker-menu"]
   ])
     connection.command([
       "bind-key",
@@ -3663,7 +3694,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",
@@ -3690,8 +3721,6 @@ var TmuxView = class {
       view.serverIdentity
     );
   }
-  view;
-  stateFile;
   connection;
   shell(argv2) {
     return `exec ${argv2.map(quote).join(" ")}`;
@@ -3863,7 +3892,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 +3915,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 +4007,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 +4019,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,
@@ -4352,8 +4408,6 @@ var MailboxError = class extends Error {
     this.retryable = retryable;
     this.name = "MailboxError";
   }
-  code;
-  retryable;
 };
 function failure(error) {
   if (error instanceof MailboxError) {
@@ -5717,6 +5771,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 +5909,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 +6051,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 +6328,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 +6453,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 +6493,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 +6519,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 {