@evref-bl/pharo-agent 0.9.1 → 0.10.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pharo-agent",
   "displayName": "Pharo Agent",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Terminal-first Pharo image setup for coding agents.",
   "author": {
     "name": "Evref-BL",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evref-bl/pharo-agent",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "private": false,
   "description": "Terminal-first Pharo integration for coding agents.",
   "license": "Apache-2.0",
@@ -26,13 +26,17 @@
     "node": ">=22.12.0"
   },
   "scripts": {
-    "check": "node --check bin/pharo-agent.js && node --check src/*.js",
+    "check": "tsc --noEmit",
     "package:check": "npm pack --dry-run",
     "test": "node --test"
   },
   "dependencies": {
-    "@evref-bl/pharo-mcp": "3.3.0",
-    "@evref-bl/plexus": "0.9.0",
+    "@evref-bl/pharo-mcp": "3.3.1",
+    "@evref-bl/plexus": "0.10.1",
     "@modelcontextprotocol/sdk": "1.32.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "typescript": "^5.9.3"
   }
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pharo-agent",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Terminal-first Pharo image setup for coding agents.",
   "author": {
     "name": "Evref-BL",

package/skills/pharo-setup/SKILL.md

@@ -8,7 +8,7 @@ Run this only when the user asks to enable or refresh Pharo tooling in this proj
 From the project root, run the released CLI that matches this plugin:
 
 ```sh
-npx --yes @evref-bl/pharo-agent@0.9.1 init --host claude
+npx --yes @evref-bl/pharo-agent@0.10.1 init --host claude
 ```
 
 Name the host this chat runs in: `--host claude` in Claude Code,

package/src/gateway.js

@@ -17,28 +17,24 @@ import {
 // release to forget, and the host shows this one to the user.
 export const { version } = createRequire(import.meta.url)("../package.json");
 
-export async function imageGateway(projectRoot, open) {
+// A route source is the directory, not the route. PLexus re-reads the state
+// file and the image's endpoint handoff every time it resolves one, so there
+// is nothing to register here and nothing that can go stale between the call
+// that opened the image and this one.
+export function imageGateway(projectRoot, open) {
   const state = readJson(open.statePath);
   const { image, mcpServerId } = selectRunningImage(state, open.imageId);
   if (image.id !== open.imageId || mcpServerId !== open.mcpServerId) {
     throw new Error(`The PLexus image ${open.imageId} changed; run pharo-agent open again.`);
   }
   const gateway = new PlexusGateway({
+    routeSources: [{ projectRoot, statePath: open.statePath }],
     pharoScope: {
       projectId: state.projectId,
       workspaceId: state.workspaceId,
-      targetId: state.targetId,
     },
     pharoToolSchemaMcpServerId: mcpServerId,
   });
-  const registered = await gateway.registerProjectRoute({
-    projectRoot,
-    statePath: open.statePath,
-    state,
-  });
-  if (!registered.ok) {
-    throw new Error(registered.error ?? "Cannot register the PLexus route.");
-  }
   return { gateway, mcpServerId, image };
 }
 
@@ -54,7 +50,7 @@ export function toolFailureMessage(error, image) {
 }
 
 export async function callImageTool(projectRoot, open, toolName, argumentsValue) {
-  const { gateway, mcpServerId, image } = await imageGateway(projectRoot, open);
+  const { gateway, mcpServerId, image } = imageGateway(projectRoot, open);
   const result = await gateway.routeToImage({
     mcpServerId,
     toolName,
@@ -69,7 +65,7 @@ export async function callImageTool(projectRoot, open, toolName, argumentsValue)
 }
 
 export async function listImageTools(projectRoot, open) {
-  const { gateway } = await imageGateway(projectRoot, open);
+  const { gateway } = imageGateway(projectRoot, open);
   return gateway.refreshPharoTools();
 }
 

package/src/images.js

@@ -37,7 +37,9 @@ export function listImages(projectRoot) {
   };
 }
 
-export function addImage(projectRoot, { id, template, category, profile }) {
+/** @param {{ id: string, template?: string, category?: string, profile?: string }} request */
+export function addImage(projectRoot, request) {
+  const { id, template, category, profile } = request;
   const config = readProjectConfig(projectRoot);
   const images = Array.isArray(config.images) ? config.images : [];
   if (images.some((image) => image.id === id)) {

package/src/init.js

@@ -181,6 +181,7 @@ function resolveInitProjectRoot(cwd) {
   return { projectRoot, createdProjectConfig: true };
 }
 
+/** @param {{ host: string, mountRoot?: string, cwd?: string }} options */
 export function initialize({ host, mountRoot, cwd = process.cwd() }) {
   const guideName = guideForHost(host);
   if (!guideName) {

package/src/live.js

@@ -360,7 +360,10 @@ export function agentImageStatus(projectRoot) {
 export async function listImageTemplates(projectRoot) {
   // `image add --template` takes a name the launcher must already know, and a
   // name that lands in two categories needs the category as well, so answer
-  // both rather than leave the caller guessing a magic string.
+  // both rather than leave the caller guessing a magic string. Listing without
+  // a category walks the groups and stamps `templateCategory` on each row, and
+  // neither it nor the launcher's own `category` is promised when the sources
+  // list names no group at all, which is why both are optional.
   const listed = await new ScopedPharoLauncher({ projectRoot }).listTemplates();
   const counts = new Map();
   for (const template of listed.templates) {