@divaltor/academy 0.4.6 → 0.6.0

package/README.md

@@ -29,6 +29,9 @@ Add Academy to `opencode.jsonc`. All options are optional. Omit the version to t
             "color": "#8994B8",
             "model": "opencode/claude-opus-5#max",
           },
+          "cafe": {
+            "disabled": true,
+          },
         },
         "experimental": {
           "communication": {
@@ -43,7 +46,7 @@ Add Academy to `opencode.jsonc`. All options are optional. Omit the version to t
 }
 ```
 
-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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divaltor/academy",
-  "version": "0.4.6",
+  "version": "0.6.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/index.ts

@@ -4,6 +4,7 @@ import { Config, Effect, Option, Redacted, Schema } from "effect";
 import { agents, rudolfCommunicationPrompt } from "./agents";
 import { FffTools } from "./fff-tools";
 import { SessionCommunication } from "./session-communication";
+import { SessionGuidance } from "./session-guidance";
 
 const ModelReference = Schema.NonEmptyString.check(
   Schema.isPattern(/^[^/#]+\/[^#]+(?:#[^#]+)?$/u)
@@ -14,6 +15,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 +55,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;
 
@@ -82,10 +90,12 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
     yield* FffTools.register(ctx);
   }
 
+  yield* SessionGuidance.register(ctx);
+
   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 +112,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 +144,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(

package/src/session-guidance.ts

@@ -0,0 +1,24 @@
+import type { Plugin } from "@opencode/plugin/effect";
+import { Effect } from "effect";
+
+export namespace SessionGuidance {
+  const anthropicRule = [
+    "Search and edit rules: never run shell `grep` or `sed`, including piped segments (`| grep`, `| sed`).",
+    '- Search: use the `grep` tool first; in shell use only `rg` (`rg -n "pattern" path`, `-F` literal, `-i` case-insensitive, `-v` invert, `-l`/`-c` files/count, `-A`/`-B`/`-C` context, `--replace` for substitutions).',
+    "- Edit/view: use Edit (or Write for new files) and Read with offset/limit instead of `sed -i`, `sed -n 'A,Bp'`, or `/pat/d`.",
+    "- `rg` is not `grep`-compatible: it recurses, respects .gitignore, and skips hidden files; add `--hidden --no-ignore` only when hidden or ignored files are explicitly required.",
+  ].join("\n");
+
+  export const register = Effect.fn("SessionGuidance.register")(
+    function* register(ctx: Plugin.Context) {
+      yield* ctx.session.hook(
+        "context",
+        (input) =>
+          Effect.sync(() => {
+            input.system.push({ text: anthropicRule, type: "text" as const });
+          }),
+        { providerID: "anthropic" }
+      );
+    }
+  );
+}