@divaltor/academy 0.3.1 → 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                 |
 | ------ | ----------------------------- |
@@ -56,6 +58,10 @@ Set `use_fff` to `true` to replace OpenCode's built-in `glob` and `grep` tools g
 
 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.
 
+> [!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.
+
 > [!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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divaltor/academy",
-  "version": "0.3.1",
+  "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
         );
       });
     }

package/src/session-communication.ts

@@ -468,8 +468,8 @@ export namespace SessionCommunication {
 
         editor.add({
           description:
-            "Use when a known session's conversation or result is needed. Without question, returns its active context directly. With question, summarizes via the thread_summary model in a dedicated session, since plugin calls carry no session for provider routing; use this instead of loading a long transcript when only specific information is needed.",
-          execute: (input) =>
+            "Use when a known session's conversation or result is needed. Without question, returns its active context directly. With question, summarizes via the thread_summary model, or the calling session's model when unset; opencode-go models route through a dedicated session, since plugin calls carry no session for provider routing. Use this instead of loading a long transcript when only specific information is needed.",
+          execute: (input, context) =>
             safe(
               Effect.gen(function* readThread() {
                 const messages = yield* ctx.session.context({
@@ -493,7 +493,14 @@ export namespace SessionCommunication {
                   "Transcript:",
                   transcript.slice(-80_000),
                 ].join("\n\n");
-                const reference = options.thread_summary ?? defaultReaderModel;
+                const current = yield* ctx.session.get({
+                  sessionID: context.sessionID,
+                });
+                const reference =
+                  options.thread_summary ??
+                  (current.model
+                    ? `${current.model.providerID}/${current.model.id}${current.model.variant ? `#${current.model.variant}` : ""}`
+                    : defaultReaderModel);
                 const ref = Model.Ref.parse(reference);
                 if (ref.providerID !== "opencode-go") {
                   const result = yield* ctx.generate.text({