@divaltor/academy 0.3.2 → 0.3.3

package/README.md

@@ -23,10 +23,12 @@ Add Academy to `opencode.jsonc`. All options are optional:
     {
       "package": "@divaltor/academy",
       "options": {
-        "rudolf": {
-          "name": "Emperor",
-          "color": "#8994B8",
-          "model": "anthropic/claude-opus-4-1#max",
+        "agents": {
+          "rudolf": {
+            "name": "Emperor",
+            "color": "#8994B8",
+            "model": "anthropic/claude-opus-4-1#max",
+          },
         },
         "communication": {
           "thread_summary": "opencode-go/glm-5.3-flash",
@@ -38,9 +40,9 @@ Add Academy to `opencode.jsonc`. All options are optional:
 }
 ```
 
-Each agent accepts `name`, `color`, and `model`. Colors may be six-digit hex values or OpenCode theme colors. Model references use `provider/model` or `provider/model#variant`.
+Each agent under `agents` accepts `name`, `color`, and `model`. Colors may be six-digit hex values or OpenCode theme colors. Model references use `provider/model` or `provider/model#variant`.
 
-Set `use_fff` to `true` to replace OpenCode's built-in `glob` and `grep` tools globally with [FFF](https://github.com/d-kimuson/fff.nvim) for every agent. This requires a platform supported by `@ff-labs/fff-bun`.
+`use_fff` replaces OpenCode's built-in `glob` and `grep` tools globally with [FFF](https://github.com/d-kimuson/fff.nvim) for every agent. Enabled by default; set to `false` to keep the built-in tools. This requires a platform supported by `@ff-labs/fff-bun`.
 
 | Agent  | Default model                 |
 | ------ | ----------------------------- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divaltor/academy",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "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

@@ -18,13 +18,17 @@ const AgentOptions = Schema.Struct({
   name: Schema.optionalKey(Schema.NonEmptyString),
 });
 
-const AcademyOptions = Schema.Struct({
+const AgentsOptions = Schema.Struct({
   agnes: Schema.optionalKey(AgentOptions),
   bellno: Schema.optionalKey(AgentOptions),
   cafe: Schema.optionalKey(AgentOptions),
-  communication: Schema.optionalKey(SessionCommunication.Options),
   dantsu: Schema.optionalKey(AgentOptions),
   rudolf: Schema.optionalKey(AgentOptions),
+});
+
+const AcademyOptions = Schema.Struct({
+  agents: Schema.optionalKey(AgentsOptions),
+  communication: Schema.optionalKey(SessionCommunication.Options),
   use_fff: Schema.optionalKey(Schema.Boolean),
 });
 
@@ -35,11 +39,15 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
   const options = yield* Schema.decodeUnknownEffect(AcademyOptions, {
     onExcessProperty: "error",
   })(ctx.options).pipe(Effect.orDie);
+  const agentOptions = options.agents ?? {};
   const agentNames = new Map(
-    agents.map((agent) => [agent.name, options[agent.id]?.name ?? agent.name])
+    agents.map((agent) => [
+      agent.name,
+      agentOptions[agent.id]?.name ?? agent.name,
+    ])
   );
   const agentID = (id: (typeof agents)[number]["id"]) =>
-    Agent.ID.make(options[id]?.name ?? id);
+    Agent.ID.make(agentOptions[id]?.name ?? id);
   const configuredAgentIDs = agents.map((agent) => agentID(agent.id));
 
   if (new Set(configuredAgentIDs).size !== configuredAgentIDs.length) {
@@ -64,7 +72,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
     });
   });
 
-  if (options.use_fff) {
+  if (options.use_fff ?? true) {
     yield* FffTools.register(ctx);
   }
 
@@ -87,7 +95,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
         agent.description = definition.description;
         agent.mode = definition.mode;
         agent.color =
-          options[definition.id]?.color ?? agent.color ?? definition.color;
+          agentOptions[definition.id]?.color ?? agent.color ?? definition.color;
         agent.system = definition.system.replaceAll(
           /\b(?:Rudolf|Agnes|Cafe|Dantsu|Bellno)\b/gu,
           (name) => agentNames.get(name) ?? name
@@ -105,7 +113,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
           };
         });
         agent.model = parseModel(
-          options[definition.id]?.model ?? definition.model
+          agentOptions[definition.id]?.model ?? definition.model
         );
       });
     }