@divaltor/academy 0.1.6 → 0.1.7

package/README.md

@@ -36,7 +36,11 @@ Add Academy to `opencode.jsonc`. Each agent can override its display name and co
 }
 ```
 
-Colors accept six-digit hex values or OpenCode theme colors: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, and `info`. You can alternatively set a color with OpenCode's native `agents.<id>.color` configuration. Custom names also update persona references. Agent IDs are `rudolf`, `bourbon`, `agnes`, `cafe`, `dantsu`, and `bellno`. See the [plugin docs](https://opencode.ai/v2/docs/build/plugins) to learn more.
+Colors accept six-digit hex values or OpenCode theme colors: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, and `info`. You can alternatively set a color with OpenCode's native `agents.<id>.color` configuration. Custom names also become the agents' IDs and update persona and permission references. Without custom names, agent IDs are `rudolf`, `bourbon`, `agnes`, `cafe`, `dantsu`, and `bellno`.
+
+> [!WARNING] Choose custom names when first setting up Academy and avoid changing them later. OpenCode stores the selected agent ID in each session, so renaming an agent removes the ID referenced by existing sessions and can prevent those sessions from continuing.
+
+See the [plugin docs](https://opencode.ai/v2/docs/build/plugins) to learn more.
 
 ### Private GitHub repositories
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divaltor/academy",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "An OpenCode plugin that trains a Tracen Academy roster of specialist coding agents to research, build, and review.",
   "homepage": "https://github.com/divaltor/academy#readme",
   "bugs": {

package/src/index.ts

@@ -27,6 +27,15 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
   const agentNames = new Map(
     agents.map((agent) => [agent.name, options[agent.id]?.name ?? agent.name])
   );
+  const agentID = (id: (typeof agents)[number]["id"]) =>
+    Agent.ID.make(options[id]?.name ?? id);
+  const configuredAgentIDs = agents.map((agent) => agentID(agent.id));
+
+  if (new Set(configuredAgentIDs).size !== configuredAgentIDs.length) {
+    return yield* Effect.die(
+      new Error("Academy agent names must produce unique agent IDs")
+    );
+  }
 
   yield* ctx.mcp.transform((editor) => {
     if (Option.isNone(githubToken)) {
@@ -50,7 +59,13 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
     }
 
     for (const definition of agents) {
-      editor.update(definition.id, (agent) => {
+      if (agentID(definition.id) !== definition.id) {
+        editor.remove(definition.id);
+      }
+    }
+
+    for (const definition of agents) {
+      editor.update(agentID(definition.id), (agent) => {
         agent.name = Agent.Name.make(
           agentNames.get(definition.name) ?? definition.name
         );
@@ -62,9 +77,18 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
           /\b(?:Rudolf|Agnes|Bourbon|Cafe|Dantsu|Bellno)\b/gu,
           (name) => agentNames.get(name) ?? name
         );
-        agent.permissions = definition.permissions.map((permission) => ({
-          ...permission,
-        }));
+        agent.permissions = definition.permissions.map((permission) => {
+          const referencedAgent = agents.find(
+            (candidate) => candidate.id === permission.resource
+          );
+
+          return {
+            ...permission,
+            resource: referencedAgent
+              ? agentID(referencedAgent.id)
+              : permission.resource,
+          };
+        });
         agent.model = definition.model
           ? {
               id: Model.ID.make(definition.model.id),
@@ -75,7 +99,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
       });
     }
 
-    editor.default("rudolf");
+    editor.default(agentID("rudolf"));
   });
 });