pi-maestro-teammate 2.2.0 → 2.4.0

package/README.md

@@ -187,7 +187,17 @@ project .pi/agents > project .agents > ~/.agents > legacy user directory > bundl
 
 ## Model Routing Profiles
 
-Configure task-type defaults with `Alt+M` or `/teammate-models`. The Control Center's **Profiles** tab manages named routing Profiles shared by every project. Its **Routing** tab edits the active global Profile and combines built-in task types, discovered agent types, and types already present in that Profile.
+Configure task-type defaults with `Alt+M` or `/teammate-models`. The Control Center's **Profiles** tab is the saved-template system: it manages multiple named routing Profiles shared by every project. Its **Routing** tab edits the active global Profile and combines built-in task types, discovered agent types, and types already present in that Profile.
+
+Switch the current project's template directly by stable Profile ID or display name. With no argument, the command opens the Control Center on **Profiles**:
+
+```text
+/teammate-model fast-lane
+/teammate-model Fast Lane
+/teammate-model
+```
+
+Command completion lists every saved template and marks the project-active and global-default entries. If display names are duplicated, use the stable ID. Direct switching disables but preserves project overrides, matching the Profiles UI.
 
 The **Roles** tab lists discovered roles and their effective durable route. Role-scoped settings can be edited through the unified Settings surface as `role.<role-name>.model`, `role.<role-name>.fallbacks`, and `role.<role-name>.thinking`. These settings are stored in the same global Profile or project override file; package updates never rewrite role definitions or user routing data.
 

package/package.json

@@ -1,209 +1,221 @@
-{
-  "name": "pi-maestro-teammate",
-  "version": "2.2.0",
-  "description": "Pi extension — teammate agent dispatch with DAG task graphs, RPC messaging, and compact TUI",
-  "type": "module",
-  "engines": {
-    "node": ">=22.19.0"
-  },
-  "bin": {
-    "pi-teammate-broker": "./bin/pi-teammate-broker.mjs",
-    "pi-teammate-models": "./bin/pi-teammate-models.mjs",
-    "pi-teammate-outbox": "./bin/pi-teammate-outbox.mjs",
-    "pi-teammate-remote": "./bin/pi-teammate-remote.mjs"
-  },
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "pi",
-    "teammate",
-    "agents"
-  ],
-  "scripts": {
-    "test": "node --experimental-transform-types --import ./test/setup.ts --test --test-concurrency=2 \"test/*.test.ts\"",
-    "typecheck": "tsc -p tsconfig.build.json",
-    "build:declarations": "tsc -p tsconfig.declarations.json",
-    "check:declarations": "node scripts/check-declarations.mjs",
-    "prepack": "npm run build:declarations && node ../../scripts/bundle-settings-core.mjs",
-    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean",
-    "test:e2e": "node --experimental-transform-types --import ./test/setup.ts --test --test-timeout=300000 test/backend-registry-dsh.e2e.test.ts",
-    "refresh:acp-registry": "node scripts/refresh-acp-registry.mjs",
-    "check:acp-registry": "node scripts/refresh-acp-registry.mjs --check"
-  },
-  "main": "./src/index.ts",
-  "types": "./types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./types/index.d.ts",
-      "default": "./src/index.ts"
-    },
-    "./v1": {
-      "types": "./types/public/v1/index.d.ts",
-      "default": "./src/public/v1/index.ts"
-    },
-    "./v1/acp-cli": {
-      "types": "./types/backends/acp-cli.d.ts",
-      "default": "./src/backends/acp-cli.ts"
-    },
-    "./v1/agents": {
-      "types": "./types/public/v1/agents.d.ts",
-      "default": "./src/public/v1/agents.ts"
-    },
-    "./v1/backends": {
-      "types": "./types/public/v1/backends.d.ts",
-      "default": "./src/public/v1/backends.ts"
-    },
-    "./v1/child-extensions": {
-      "types": "./types/public/v1/child-extensions.d.ts",
-      "default": "./src/public/v1/child-extensions.ts"
-    },
-    "./v1/events": {
-      "types": "./types/public/v1/events.d.ts",
-      "default": "./src/public/v1/events.ts"
-    },
-    "./v1/execution": {
-      "types": "./types/public/v1/execution.d.ts",
-      "default": "./src/public/v1/execution.ts"
-    },
-    "./v1/extension": {
-      "types": "./types/public/v1/extension.d.ts",
-      "default": "./src/public/v1/extension.ts"
-    },
-    "./v1/model-routing": {
-      "types": "./types/public/v1/model-routing.d.ts",
-      "default": "./src/public/v1/model-routing.ts"
-    },
-    "./v1/cli-tools": {
-      "types": "./types/public/v1/cli-tools.d.ts",
-      "default": "./src/public/v1/cli-tools.ts"
-    },
-    "./v1/completion-durability": {
-      "types": "./types/public/v1/completion-durability.d.ts",
-      "default": "./src/public/v1/completion-durability.ts"
-    },
-    "./v1/mailbox": {
-      "types": "./types/public/v1/mailbox.d.ts",
-      "default": "./src/public/v1/mailbox.ts"
-    },
-    "./v1/observation": {
-      "types": "./types/public/v1/observation.d.ts",
-      "default": "./src/public/v1/observation.ts"
-    },
-    "./v1/progress-tree": {
-      "types": "./types/public/v1/progress-tree.d.ts",
-      "default": "./src/public/v1/progress-tree.ts"
-    },
-    "./v1/remote": {
-      "types": "./types/public/v1/remote.d.ts",
-      "default": "./src/public/v1/remote.ts"
-    },
-    "./v1/retry": {
-      "types": "./types/public/v1/retry.d.ts",
-      "default": "./src/public/v1/retry.ts"
-    },
-    "./v1/scheduler": {
-      "types": "./types/public/v1/scheduler.d.ts",
-      "default": "./src/public/v1/scheduler.ts"
-    },
-    "./v1/sessions": {
-      "types": "./types/public/v1/sessions.d.ts",
-      "default": "./src/public/v1/sessions.ts"
-    },
-    "./v1/supervision": {
-      "types": "./types/public/v1/supervision.d.ts",
-      "default": "./src/public/v1/supervision.ts"
-    },
-    "./v1/workspace-projections": {
-      "types": "./types/public/v1/workspace-projections.d.ts",
-      "default": "./src/public/v1/workspace-projections.ts"
-    },
-    "./v1/workspace-completion": {
-      "types": "./types/public/v1/workspace-completion.d.ts",
-      "default": "./src/public/v1/workspace-completion.ts"
-    },
-    "./v1/todo-context": {
-      "types": "./types/public/v1/todo-context.d.ts",
-      "default": "./src/public/v1/todo-context.ts"
-    },
-    "./v1/types": {
-      "types": "./types/public/v1/types.d.ts",
-      "default": "./src/public/v1/types.ts"
-    },
-    "./v2/runtime": {
-      "types": "./types/public/v2/runtime.d.ts",
-      "default": "./src/public/v2/runtime.ts"
-    },
-    "./v2/runtime-broker": {
-      "types": "./types/public/v2/runtime-broker.d.ts",
-      "default": "./src/public/v2/runtime-broker.ts"
-    },
-    "./src/*": "./src/*"
-  },
-  "deprecatedSubpaths": {
-    "./src/*": "Compatibility only; use the versioned ./v1/* public API."
-  },
-  "files": [
-    "bin/*.mjs",
-    "src/**/*.{ts,json}",
-    "types/**/*.d.ts",
-    "agents/",
-    "README.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./src/extension/index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-agent-core": "*",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "typebox": "*"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-agent-core": {
-      "optional": true
-    },
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@agentclientprotocol/sdk": "1.3.0",
-    "cross-spawn": "7.0.6",
-    "jiti": "2.7.0",
-    "pi-maestro-settings-core": "0.2.1",
-    "pi-maestro-backend-core": "*",
-    "pi-maestro-backends": "*",
-    "proper-lockfile": "4.1.2",
-    "ssh2": "1.17.0",
-    "zod": "4.4.3"
-  },
-  "bundledDependencies": [
-    "pi-maestro-settings-core"
-  ],
-  "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.83.0",
-    "@types/cross-spawn": "6.0.6",
-    "@earendil-works/pi-ai": "0.83.0",
-    "@earendil-works/pi-coding-agent": "0.83.0",
-    "@earendil-works/pi-tui": "0.83.0",
-    "@types/ssh2": "1.15.5",
-    "typebox": "1.3.7"
-  },
-  "directories": {
-    "test": "test"
-  },
-  "author": "",
-  "license": "ISC"
-}
+{
+  "name": "pi-maestro-teammate",
+  "version": "2.4.0",
+  "description": "Pi extension — teammate agent dispatch with DAG task graphs, RPC messaging, and compact TUI",
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "bin": {
+    "pi-teammate-broker": "./bin/pi-teammate-broker.mjs",
+    "pi-teammate-models": "./bin/pi-teammate-models.mjs",
+    "pi-teammate-outbox": "./bin/pi-teammate-outbox.mjs",
+    "pi-teammate-remote": "./bin/pi-teammate-remote.mjs"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "teammate",
+    "agents"
+  ],
+  "scripts": {
+    "test": "node --experimental-transform-types --import ./test/setup.ts --test --test-concurrency=2 \"test/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.build.json",
+    "build:declarations": "tsc -p tsconfig.declarations.json",
+    "check:declarations": "node scripts/check-declarations.mjs",
+    "prepack": "npm run build:declarations && node ../../scripts/bundle-settings-core.mjs",
+    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean",
+    "test:e2e": "node --experimental-transform-types --import ./test/setup.ts --test --test-timeout=300000 test/backend-registry-dsh.e2e.test.ts",
+    "refresh:acp-registry": "node scripts/refresh-acp-registry.mjs",
+    "check:acp-registry": "node scripts/refresh-acp-registry.mjs --check"
+  },
+  "main": "./src/index.ts",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./v1": {
+      "types": "./types/public/v1/index.d.ts",
+      "default": "./src/public/v1/index.ts"
+    },
+    "./v1/acp-cli": {
+      "types": "./types/backends/acp-cli.d.ts",
+      "default": "./src/backends/acp-cli.ts"
+    },
+    "./v1/agents": {
+      "types": "./types/public/v1/agents.d.ts",
+      "default": "./src/public/v1/agents.ts"
+    },
+    "./v1/backends": {
+      "types": "./types/public/v1/backends.d.ts",
+      "default": "./src/public/v1/backends.ts"
+    },
+    "./v1/child-extensions": {
+      "types": "./types/public/v1/child-extensions.d.ts",
+      "default": "./src/public/v1/child-extensions.ts"
+    },
+    "./v1/events": {
+      "types": "./types/public/v1/events.d.ts",
+      "default": "./src/public/v1/events.ts"
+    },
+    "./v1/execution": {
+      "types": "./types/public/v1/execution.d.ts",
+      "default": "./src/public/v1/execution.ts"
+    },
+    "./v1/extension": {
+      "types": "./types/public/v1/extension.d.ts",
+      "default": "./src/public/v1/extension.ts"
+    },
+    "./v1/model-routing": {
+      "types": "./types/public/v1/model-routing.d.ts",
+      "default": "./src/public/v1/model-routing.ts"
+    },
+    "./v1/monitor-window-state": {
+      "types": "./types/public/v1/monitor-window-state.d.ts",
+      "default": "./src/public/v1/monitor-window-state.ts"
+    },
+    "./v1/cli-tools": {
+      "types": "./types/public/v1/cli-tools.d.ts",
+      "default": "./src/public/v1/cli-tools.ts"
+    },
+    "./v1/completion-durability": {
+      "types": "./types/public/v1/completion-durability.d.ts",
+      "default": "./src/public/v1/completion-durability.ts"
+    },
+    "./v1/mailbox": {
+      "types": "./types/public/v1/mailbox.d.ts",
+      "default": "./src/public/v1/mailbox.ts"
+    },
+    "./v1/observation": {
+      "types": "./types/public/v1/observation.d.ts",
+      "default": "./src/public/v1/observation.ts"
+    },
+    "./v1/progress-tree": {
+      "types": "./types/public/v1/progress-tree.d.ts",
+      "default": "./src/public/v1/progress-tree.ts"
+    },
+    "./v1/remote": {
+      "types": "./types/public/v1/remote.d.ts",
+      "default": "./src/public/v1/remote.ts"
+    },
+    "./v1/retry": {
+      "types": "./types/public/v1/retry.d.ts",
+      "default": "./src/public/v1/retry.ts"
+    },
+    "./v1/session-history": {
+      "types": "./types/public/v1/session-history.d.ts",
+      "default": "./src/public/v1/session-history.ts"
+    },
+    "./v1/scheduler": {
+      "types": "./types/public/v1/scheduler.d.ts",
+      "default": "./src/public/v1/scheduler.ts"
+    },
+    "./v1/sessions": {
+      "types": "./types/public/v1/sessions.d.ts",
+      "default": "./src/public/v1/sessions.ts"
+    },
+    "./v1/supervision": {
+      "types": "./types/public/v1/supervision.d.ts",
+      "default": "./src/public/v1/supervision.ts"
+    },
+    "./v1/ssh-hosts": {
+      "types": "./types/public/v1/ssh-hosts.d.ts",
+      "default": "./src/public/v1/ssh-hosts.ts"
+    },
+    "./v1/workspace-projections": {
+      "types": "./types/public/v1/workspace-projections.d.ts",
+      "default": "./src/public/v1/workspace-projections.ts"
+    },
+    "./v1/workspace-completion": {
+      "types": "./types/public/v1/workspace-completion.d.ts",
+      "default": "./src/public/v1/workspace-completion.ts"
+    },
+    "./v1/todo-context": {
+      "types": "./types/public/v1/todo-context.d.ts",
+      "default": "./src/public/v1/todo-context.ts"
+    },
+    "./v1/types": {
+      "types": "./types/public/v1/types.d.ts",
+      "default": "./src/public/v1/types.ts"
+    },
+    "./v2/runtime": {
+      "types": "./types/public/v2/runtime.d.ts",
+      "default": "./src/public/v2/runtime.ts"
+    },
+    "./v2/runtime-broker": {
+      "types": "./types/public/v2/runtime-broker.d.ts",
+      "default": "./src/public/v2/runtime-broker.ts"
+    },
+    "./src/*": "./src/*"
+  },
+  "deprecatedSubpaths": {
+    "./src/*": "Compatibility only; use the versioned ./v1/* public API."
+  },
+  "files": [
+    "bin/*.mjs",
+    "src/**/*.{ts,json}",
+    "types/**/*.d.ts",
+    "agents/",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/extension/index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-agent-core": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "1.3.0",
+    "cross-spawn": "7.0.6",
+    "jiti": "2.7.0",
+    "pi-maestro-settings-core": "0.2.1",
+    "pi-maestro-backend-core": "*",
+    "pi-maestro-backends": "*",
+    "proper-lockfile": "4.1.2",
+    "ssh2": "1.17.0",
+    "zod": "4.4.3"
+  },
+  "bundledDependencies": [
+    "pi-maestro-settings-core"
+  ],
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.84.4",
+    "@types/cross-spawn": "6.0.6",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
+    "@types/ssh2": "1.15.5",
+    "typebox": "1.3.7"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "author": "",
+  "license": "ISC"
+}

package/src/backends/acp-cli-catalog.ts

@@ -43,6 +43,9 @@ export const ACP_CLI_SETTINGS_CATALOGS: TranslationCatalogs = {
     "acpCli.mode": "Launch mode",
     "acpCli.mode.local": "Local process",
     "acpCli.mode.ssh": "Remote over SSH",
+    "acpCli.sshHostRef": "/ssh host reference",
+    "acpCli.sshHostRef.description":
+      "Host id from the unlocked encrypted /ssh manager. Use it instead of every embedded SSH connection field; the host is resolved again for each run.",
     "acpCli.host": "SSH host",
     "acpCli.user": "SSH user",
     "acpCli.port": "SSH port",
@@ -92,6 +95,9 @@ export const ACP_CLI_SETTINGS_CATALOGS: TranslationCatalogs = {
     "acpCli.mode": "启动方式",
     "acpCli.mode.local": "本地进程",
     "acpCli.mode.ssh": "经 SSH 远程",
+    "acpCli.sshHostRef": "/ssh 主机引用",
+    "acpCli.sshHostRef.description":
+      "已解锁加密 /ssh 管理器中的主机 id。它必须替代全部内嵌 SSH 连接字段，并在每次运行时重新解析。",
     "acpCli.host": "SSH 主机",
     "acpCli.user": "SSH 用户",
     "acpCli.port": "SSH 端口",

package/src/backends/acp-cli.ts

@@ -52,6 +52,7 @@ import type {
 import {
   cliToolArgv,
   probeCliToolCommand,
+  sshHostConfigIssue,
   type CliToolConfig,
 } from "../cli-tools/cli-tools-config.ts";
 import {
@@ -282,9 +283,18 @@ export const ACP_CLI_CONFIG_FIELDS: readonly BackendConfigField[] = [
     labelKey: "acpCli.mode",
     default: "local",
   },
+  {
+    key: "sshHostRef",
+    kind: "text",
+    labelKey: "acpCli.sshHostRef",
+    descriptionKey: "acpCli.sshHostRef.description",
+  },
   { key: "host", kind: "text", labelKey: "acpCli.host" },
   { key: "user", kind: "text", labelKey: "acpCli.user" },
-  { key: "port", kind: "integer", labelKey: "acpCli.port", default: 22 },
+  // Applied only to embedded SSH below. Leaving this declaration without a
+  // generic default lets validation distinguish an explicit override from a
+  // reference that must take its port exclusively from `/ssh`.
+  { key: "port", kind: "integer", labelKey: "acpCli.port" },
   { key: "hostKeySha256", kind: "text", labelKey: "acpCli.hostKeySha256" },
   { key: "identityFile", kind: "path", labelKey: "acpCli.identityFile" },
   {
@@ -420,6 +430,7 @@ async function installedLaunchConfig(
 function launchConfigOf(config: Record<string, ConfigValue>): CliToolConfig {
   const command = text(config, "command");
   const cwd = text(config, "cwd");
+  const sshHostRef = text(config, "sshHostRef");
   const host = text(config, "host");
   const user = text(config, "user");
   const port = count(config, "port");
@@ -432,6 +443,7 @@ function launchConfigOf(config: Record<string, ConfigValue>): CliToolConfig {
     args: list(config, "args"),
     ...(cwd === undefined ? {} : { cwd }),
     env: list(config, "env"),
+    ...(sshHostRef === undefined ? {} : { sshHostRef }),
     ...(host === undefined ? {} : { host }),
     ...(user === undefined ? {} : { user }),
     ...(port === undefined ? {} : { port }),
@@ -605,14 +617,18 @@ export function createAcpCliBackend(
           + "parent process forwards by name; a name=value entry puts the value in the registration document",
         );
       }
-      // Checked at load rather than at launch: the runner's ssh path already
-      // fails closed on an incomplete host, but it does so per run, long after
-      // the operator stopped looking at the file that caused it.
+      // Checked at load rather than at launch: one SSH source must be complete
+      // and authoritative. A reference cannot be paired with even a seemingly
+      // harmless port override, because that would recreate two sources of
+      // truth for the connection.
       if (mode === "ssh") {
-        for (const key of ["host", "user", "hostKeySha256"]) {
-          if ((text(config, key) ?? "").trim().length > 0) continue;
-          errors.push(`"${key}" is required when "mode" is "ssh"`);
+        const issue = sshHostConfigIssue(launchConfigOf(values));
+        if (issue !== undefined) errors.push(issue);
+        else if ((text(values, "sshHostRef") ?? "").trim().length === 0 && count(values, "port") === undefined) {
+          values.port = 22;
         }
+      } else if ((text(values, "sshHostRef") ?? "").trim().length > 0) {
+        errors.push('"sshHostRef" requires "mode" to be "ssh"');
       }
       return { values, errors };
     },
@@ -638,7 +654,7 @@ export function createAcpCliBackend(
         // beats returning the local machine's answer for a remote target.
         throw new Error(
           `teammate backend "acp-cli" cannot list "${field}" for an "ssh" registration: `
-          + "the probe launches the agent locally, so the target host's catalogue is not reachable here",
+          + "whether embedded or selected by sshHostRef, the target host's catalogue is not reachable by the local probe",
         );
       }
       const route = routeOf(config);