@divaltor/academy 0.3.2 → 0.4.0

package/README.md

@@ -23,13 +23,17 @@ 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",
+        "experimental": {
+          "communication": {
+            "thread_summary": "opencode-go/glm-5.3-flash",
+          },
         },
         "use_fff": true,
       },
@@ -38,9 +42,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                 |
 | ------ | ----------------------------- |
@@ -54,15 +58,15 @@ Set `use_fff` to `true` to replace OpenCode's built-in `glob` and `grep` tools g
 >
 > An agent's name is also its session ID. Renaming it can prevent existing sessions from continuing.
 
-Session tools are available under Code Mode's `academy` namespace. Only the root primary session can create threads; omit `agent` for a general coding session.
+Session tools are experimental and off by default; set `experimental.communication` to enable them. They are available under Code Mode's `academy` namespace. Only the root primary session can create threads; omit `agent` for a general coding session.
 
 > [!NOTE]
 >
-> `read_thread` with a question summarizes via the `communication.thread_summary` model, or the calling session's model when unset. Models on `opencode-go` cannot use stateless generation (the provider requires session routing headers that only a session request carries), so Academy answers through a dedicated `Academy summary <model>` session via transient `session.generate` — no transcript writes, but the session stays visible in the session list because the plugin API exposes neither archive nor delete for it.
+> `read_thread` with a question summarizes via the `experimental.communication.thread_summary` model, or the calling session's model when unset. Models on `opencode-go` cannot use stateless generation (the provider requires session routing headers that only a session request carries), so Academy answers through a dedicated `Academy summary <model>` session via transient `session.generate` — no transcript writes, but the session stays visible in the session list because the plugin API exposes neither archive nor delete for it.
 
 > [!NOTE]
 >
-> `find_thread` currently searches Academy-created sessions only. OpenCode's HTTP client can list persisted sessions, but the plugin context does not yet expose `ctx.session.list`, so Academy cannot safely discover sessions created before the plugin was installed. We are waiting for upstream support rather than reading OpenCode's private SQLite database or connecting back to the server through a separate client.
+> `find_thread` currently searches Academy-created sessions only and is part of the experimental communication tools. OpenCode's HTTP client can list persisted sessions, but the plugin context does not yet expose `ctx.session.list`, so Academy cannot safely discover sessions created before the plugin was installed. We are waiting for upstream support rather than reading OpenCode's private SQLite database or connecting back to the server through a separate client.
 >
 > Tracking: [#43517](https://github.com/anomalyco/opencode/issues/43517), [#44155](https://github.com/anomalyco/opencode/issues/44155), [#43556](https://github.com/anomalyco/opencode/pull/43556), and [#46690](https://github.com/anomalyco/opencode/pull/46690).
 

package/package.json

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

package/src/agents/rudolf-communication.txt

@@ -0,0 +1,6 @@
+## Session collaboration
+
+- Academy session tools are available through Code Mode's `academy` namespace. Use Code Mode search when an exact signature is not listed and asynchronous or resumable work would materially help.
+- Only Rudolf creates and controls these sessions. Use native subagents for bounded work whose result is needed immediately; use an Academy thread for independently specifiable work that can proceed concurrently or may need follow-up later. Never delegate the same work through both paths.
+- Give each thread a complete prompt and non-overlapping ownership because it does not inherit this conversation. Retain the returned session ID, continue useful work, and wait only when its result becomes necessary.
+- Use `find_thread` to recover prior Academy work, `send_thread_message` for corrections or added context, and `interrupt_thread` only for obsolete or wrong-premise work. Read and verify the result before synthesizing it for the user.

package/src/agents/rudolf.txt

@@ -29,13 +29,6 @@ You are **Rudolf**, the primary coding agent. Work directly by default and deliv
 - Give delegates the goal, relevant context, constraints, non-goals, and required result. Parallelize only independent work and never assign overlapping writes.
 - Verify consequential delegated claims and local fit, inspect delegated changes, and synthesize the user-facing result yourself.
 
-## Session collaboration
-
-- Academy session tools are available through Code Mode's `academy` namespace. Use Code Mode search when an exact signature is not listed and asynchronous or resumable work would materially help.
-- Only Rudolf creates and controls these sessions. Use native subagents for bounded work whose result is needed immediately; use an Academy thread for independently specifiable work that can proceed concurrently or may need follow-up later. Never delegate the same work through both paths.
-- Give each thread a complete prompt and non-overlapping ownership because it does not inherit this conversation. Retain the returned session ID, continue useful work, and wait only when its result becomes necessary.
-- Use `find_thread` to recover prior Academy work, `send_thread_message` for corrections or added context, and `interrupt_thread` only for obsolete or wrong-premise work. Read and verify the result before synthesizing it for the user.
-
 # Communication
 
 - Default to roughly ten lines of prose per answer. Add structure only when it carries information.

package/src/agents.ts

@@ -4,6 +4,8 @@ import cafeSystem from "./agents/cafe.txt" with { type: "text" };
 import dantsuSystem from "./agents/dantsu.txt" with { type: "text" };
 import rudolfSystem from "./agents/rudolf.txt" with { type: "text" };
 
+export { default as rudolfCommunicationPrompt } from "./agents/rudolf-communication.txt" with { type: "text" };
+
 interface Permission {
   readonly action: string;
   readonly resource: string;

package/src/index.ts

@@ -1,7 +1,7 @@
 import { Agent, Model, Plugin } from "@opencode/plugin/effect";
 import { Config, Effect, Option, Redacted, Schema } from "effect";
 
-import { agents } from "./agents";
+import { agents, rudolfCommunicationPrompt } from "./agents";
 import { FffTools } from "./fff-tools";
 import { SessionCommunication } from "./session-communication";
 
@@ -18,13 +18,21 @@ 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 ExperimentalOptions = Schema.Struct({
+  communication: Schema.optionalKey(SessionCommunication.Options),
+});
+
+const AcademyOptions = Schema.Struct({
+  agents: Schema.optionalKey(AgentsOptions),
+  experimental: Schema.optionalKey(ExperimentalOptions),
   use_fff: Schema.optionalKey(Schema.Boolean),
 });
 
@@ -35,12 +43,17 @@ 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));
+  const communication = options.experimental?.communication;
 
   if (new Set(configuredAgentIDs).size !== configuredAgentIDs.length) {
     return yield* Effect.die(
@@ -64,7 +77,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,8 +100,15 @@ 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;
-        agent.system = definition.system.replaceAll(
+          agentOptions[definition.id]?.color ?? agent.color ?? definition.color;
+        const base =
+          definition.id === "rudolf" && communication !== undefined
+            ? definition.system.replace(
+                "# Communication",
+                `${rudolfCommunicationPrompt}\n\n# Communication`
+              )
+            : definition.system;
+        agent.system = base.replaceAll(
           /\b(?:Rudolf|Agnes|Cafe|Dantsu|Bellno)\b/gu,
           (name) => agentNames.get(name) ?? name
         );
@@ -105,7 +125,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
         );
       });
     }
@@ -113,11 +133,9 @@ const setup = Effect.fn("Academy.setup")(function* setup(ctx: Plugin.Context) {
     editor.default(agentID("rudolf"));
   });
 
-  yield* SessionCommunication.register(
-    ctx,
-    options.communication ?? {},
-    agentID("rudolf")
-  );
+  if (communication !== undefined) {
+    yield* SessionCommunication.register(ctx, communication, agentID("rudolf"));
+  }
 });
 
 export default Plugin.define({