@divaltor/academy 0.4.3 → 0.5.0

package/README.md

@@ -14,7 +14,7 @@ An OpenCode plugin that turns coding agents into a Tracen Academy roster: specia
 
 ## Configuration
 
-Add Academy to `opencode.jsonc`. All options are optional:
+Add Academy to `opencode.jsonc`. All options are optional. Omit the version to track `latest`; append `@x.y.z` to pin a release:
 
 ```jsonc
 {
@@ -29,6 +29,9 @@ Add Academy to `opencode.jsonc`. All options are optional:
             "color": "#8994B8",
             "model": "opencode/claude-opus-5#max",
           },
+          "cafe": {
+            "disabled": true,
+          },
         },
         "experimental": {
           "communication": {
@@ -43,7 +46,9 @@ Add Academy to `opencode.jsonc`. All options are optional:
 }
 ```
 
-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`.
+Each agent under `agents` accepts `name`, `color`, `model`, and `disabled`. Colors may be six-digit hex values or OpenCode theme colors. Model references use `provider/model` or `provider/model#variant`. Set `disabled` to `true` to hide an agent and prevent new subagent or Academy thread creation while retaining its definition so existing sessions can continue. Disabling Rudolf restores OpenCode's Build agent as the default.
+
+Without a version suffix OpenCode resolves `latest` on install; run `opencode plugin update` to pull newer releases.
 
 `use_fff` replaces OpenCode's built-in `glob` and `grep` tools globally with [FFF](https://github.com/dmtrKovalenko/fff) 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`.
 
@@ -51,9 +56,9 @@ Each agent under `agents` accepts `name`, `color`, and `model`. Colors may be si
 | ------ | ----------------------------- |
 | Rudolf | OpenCode's configured default |
 | Agnes  | `openai/gpt-6-astra#xhigh`    |
-| Cafe   | `openai/gpt-5.6-sol#none`     |
-| Dantsu | `openai/gpt-5.6-terra#low`    |
-| Bellno | `openai/gpt-5.6-sol#high`     |
+| Cafe   | `openai/gpt-6-sol#none`       |
+| Dantsu | `openai/gpt-6-luna#high`      |
+| Bellno | `openai/gpt-6-sol#high`       |
 
 > [!WARNING]
 >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divaltor/academy",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "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": {
@@ -29,7 +29,7 @@
     "fix": "ultracite fix"
   },
   "dependencies": {
-    "@ff-labs/fff-bun": "0.10.6",
+    "@ff-labs/fff-bun": "0.11.0",
     "@opencode/plugin": "2.0.11",
     "@opencode/schema": "2.0.11",
     "effect": "4.0.0-rc.112"

package/src/agents/agnes.txt

@@ -2,7 +2,7 @@ You are **Agnes**, a read-only technical advisor for difficult judgment calls. I
 
 # Principles
 
-- Do not make code-specific findings or recommendations about implementation you have not examined. Read the decisive supplied files or diff and relevant callers before advising. If that evidence is unavailable, state the limitation and give only a conditional recommendation.
+- Read the decisive files or diff and relevant callers, validation, and boundary adapters before making code-specific claims or recommendations. Distinguish what the evidence proves from what you infer. If decisive evidence is unavailable, state the limitation and keep the recommendation conditional.
 - Prefer the simplest viable change; reuse existing code, patterns, and dependencies. Resist hypothetical future needs.
 - Give one recommended path; mention an alternative only when the trade-off materially matters. Stop when the intent, decisive implementation path, contract to preserve, material risks, and smallest viable recommendation are clear.
 - For reviews, infer intended behavior and report only high-confidence actionable findings. For debugging, trace the bad value or behavior to where it is first produced. For plans, state the observable behavior or test that would prove the change correct.

package/src/agents/cafe.txt

@@ -14,4 +14,4 @@ You are **Cafe**, an external research subagent. Return evidence-backed answers
 
 # Response
 
-Lead with the answer. Support material claims with linked sources; use versioned documentation anchors and commit-pinned repository links when relevant. Distinguish documented behavior, source-confirmed behavior, observed practice, and inference when the distinction matters. Include code only when it clarifies the requested usage, and language-tag it. Omit generic preambles and raw URLs. Keep reports under roughly 250 words as a flat list without headings.
+Lead with the answer. Support material claims with linked sources; use versioned documentation anchors and commit-pinned repository links when relevant. Distinguish documented behavior, source-confirmed behavior, observed practice, and inference when the distinction matters. Include code only when it clarifies the requested usage, and language-tag it. Omit generic preambles and raw URLs. Default to a flat list of roughly 250 words or fewer; use short sections or additional detail only when needed to answer the question completely.

package/src/agents/dantsu.txt

@@ -14,4 +14,4 @@ Use grep for workspace content, glob for workspace paths, and read to confirm.
 
 # Response
 
-Lead with the direct answer, then list absolute path and line evidence and why each location matters. State material scope limits or uncertainty.
+Lead with the direct answer and briefly explain the mechanism or call/data flow when relevant. List absolute paths and line ranges for the decisive definition and only the callers or tests needed to support the answer; say what each establishes. For cited tests, state what their assertions check. Keep the evidence map concise. State material scope limits or uncertainty.

package/src/agents.ts

@@ -90,7 +90,7 @@ export const agents: readonly AcademyAgent[] = [
       "Librarian-style external research for official docs, API behavior, dependency internals, and remote repositories.",
     id: "cafe",
     mode: "subagent",
-    model: "openai/gpt-5.6-sol#none",
+    model: "openai/gpt-6-sol#none",
     name: "Cafe",
     permissions: [
       ...defaultPermissions,
@@ -113,7 +113,7 @@ export const agents: readonly AcademyAgent[] = [
       "Finder-style local codebase discovery by behavior, ownership boundary, and call or data flow.",
     id: "dantsu",
     mode: "subagent",
-    model: "openai/gpt-5.6-terra#low",
+    model: "openai/gpt-6-luna#high",
     name: "Dantsu",
     permissions: [
       ...defaultPermissions,
@@ -135,7 +135,7 @@ export const agents: readonly AcademyAgent[] = [
       "Read-only general reviewer for complete, systematic reviews of diffs, commits, branches, and pull requests.",
     id: "bellno",
     mode: "subagent",
-    model: "openai/gpt-5.6-sol#high",
+    model: "openai/gpt-6-sol#high",
     name: "Bellno",
     permissions: [
       ...defaultPermissions,

package/src/index.ts

@@ -14,6 +14,7 @@ const parseModel = (reference: string | undefined) =>
 
 const AgentOptions = Schema.Struct({
   color: Schema.optionalKey(Agent.Color),
+  disabled: Schema.optionalKey(Schema.Boolean),
   model: Schema.optionalKey(ModelReference),
   name: Schema.optionalKey(Schema.NonEmptyString),
 });
@@ -53,6 +54,12 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
   const agentID = (id: (typeof agents)[number]["id"]) =>
     Agent.ID.make(agentOptions[id]?.name ?? id);
   const configuredAgentIDs = agents.map((agent) => agentID(agent.id));
+  const disabledAgentIDs = new Set(
+    agents
+      .filter((agent) => agentOptions[agent.id]?.disabled === true)
+      .map((agent) => agentID(agent.id))
+  );
+  const rudolfDisabled = disabledAgentIDs.has(agentID("rudolf"));
   const communication = options.experimental?.communication;
   const communicationEnabled = communication?.enabled === true;
 
@@ -85,7 +92,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
   yield* ctx.agent.transform((editor) => {
     for (const id of ["build", "plan", "explore", "general"]) {
       editor.update(id, (agent) => {
-        agent.hidden = true;
+        agent.hidden = !(id === "build" && rudolfDisabled);
       });
     }
 
@@ -102,6 +109,7 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
         );
         agent.description = definition.description;
         agent.mode = definition.mode;
+        agent.hidden = disabledAgentIDs.has(agentID(definition.id));
         agent.color =
           agentOptions[definition.id]?.color ?? agent.color ?? definition.color;
         const base =
@@ -133,11 +141,36 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
       });
     }
 
+    for (const agent of editor.list()) {
+      editor.update(agent.id, (editable) => {
+        editable.permissions.push(
+          ...disabledAgentIDs.values().map((id) => ({
+            action: "subagent",
+            effect: "deny" as const,
+            resource: id,
+          }))
+        );
+      });
+    }
+
+    if (rudolfDisabled) {
+      editor.default(
+        editor.list().find((agent) => agent.mode === "primary" && !agent.hidden)
+          ?.id
+      );
+      return;
+    }
+
     editor.default(agentID("rudolf"));
   });
 
   if (communication !== undefined && communicationEnabled) {
-    yield* SessionCommunication.register(ctx, communication, agentID("rudolf"));
+    yield* SessionCommunication.register(
+      ctx,
+      communication,
+      agentID("rudolf"),
+      disabledAgentIDs
+    );
   }
 });
 

package/src/session-communication.ts

@@ -206,7 +206,8 @@ export namespace SessionCommunication {
     function* register(
       ctx: Plugin.Context,
       options: Options,
-      primaryAgent: Agent.ID
+      primaryAgent: Agent.ID,
+      disabledAgentIDs: ReadonlySet<Agent.ID>
     ) {
       const scanRecords = Effect.fn("SessionCommunication.scanThreadRecords")(
         function* scanThreadRecords(
@@ -340,6 +341,12 @@ export namespace SessionCommunication {
                     "only the primary Academy session can create threads"
                   );
                 }
+                if (
+                  input.agent !== undefined &&
+                  disabledAgentIDs.has(input.agent)
+                ) {
+                  return failure(`agent ${input.agent} is disabled`);
+                }
 
                 const detached = input.detached ?? false;
                 const depth = yield* threadDepthFor(