@alisio/plugin-subagents 0.1.0-alpha.8 → 0.1.0

package/dist/config.d.ts

@@ -23,6 +23,11 @@ export declare const subagentsConfigSchema: z.ZodObject<{
         prompt: z.ZodDefault<z.ZodString>;
         tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         model: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            primary: "primary";
+            subagent: "subagent";
+        }>>;
     }, z.core.$strip>>>;
     worktreeDir: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;

package/dist/config.js

@@ -4,6 +4,8 @@ const cliAgent = z.object({
     prompt: z.string().default(""),
     tools: z.array(z.string()).optional(),
     model: z.string().optional(),
+    /** `primary`/`all` makes the definition available as an ACTIVE (main-session) agent in `/agents`. */
+    mode: z.enum(["subagent", "primary", "all"]).optional(),
 });
 /** Options under `builtinPlugins.subagents`. */
 export const subagentsConfigSchema = z

package/dist/definitions.d.ts

@@ -20,6 +20,8 @@ export interface AgentDefinition {
     hidden: boolean;
     background: boolean;
     skills?: string[];
+    /** Default reasoning effort (`alisio.reasoning.effort`, written by the Alisio agent manager). */
+    effort?: string;
     /** builtin | cli | project | convention | compat | user | plugin:<id> */
     source: string;
     path?: string;
@@ -37,11 +39,13 @@ export interface CliAgent {
     prompt: string;
     tools?: string[];
     model?: string;
+    mode?: "subagent" | "primary" | "all";
 }
 /**
  * Discovery, first match wins by name: CLI `--agents` > project `.alisio/agents` >
- * `.agents/agents` (speculative convention) > compat `.claude/agents`, `.opencode/agent(s)`
- * > user `<config>/agents`, `~/.claude/agents`, `~/.config/opencode/agent(s)` > plugin
+ * `.agents/agents` (shared convention, written by the Alisio agent manager) > compat
+ * `.claude/agents`, `.opencode/agent(s)` > user `<config>/agents`, `~/.agents/agents`,
+ * `~/.claude/agents`, `~/.config/opencode/agent(s)` > plugin
  * directories (namespaced `plugin:name`) > built-ins. Project sources require trust.
  */
 export declare function discoverAgents(options: {

package/dist/definitions.js

@@ -22,6 +22,8 @@ const KNOWN = new Set([
     "background",
     "skills",
     "readOnly",
+    // Alisio-only settings written by the agent manager (other harnesses ignore this key).
+    "alisio",
     // Compat keys accepted silently.
     "temperature",
     "top_p",
@@ -137,6 +139,10 @@ export function parseAgentDefinition(text, meta) {
     const skills = list(front.skills);
     if (skills)
         definition.skills = skills;
+    const effort = front.alisio?.reasoning
+        ?.effort;
+    if (typeof effort === "string" && /^[a-z][a-z_-]{0,19}$/.test(effort))
+        definition.effort = effort;
     return { definition, warnings };
 }
 export const BUILTIN_AGENTS = [
@@ -209,8 +215,9 @@ async function readDir(dir) {
 }
 /**
  * Discovery, first match wins by name: CLI `--agents` > project `.alisio/agents` >
- * `.agents/agents` (speculative convention) > compat `.claude/agents`, `.opencode/agent(s)`
- * > user `<config>/agents`, `~/.claude/agents`, `~/.config/opencode/agent(s)` > plugin
+ * `.agents/agents` (shared convention, written by the Alisio agent manager) > compat
+ * `.claude/agents`, `.opencode/agent(s)` > user `<config>/agents`, `~/.agents/agents`,
+ * `~/.claude/agents`, `~/.config/opencode/agent(s)` > plugin
  * directories (namespaced `plugin:name`) > built-ins. Project sources require trust.
  */
 export async function discoverAgents(options) {
@@ -224,7 +231,13 @@ export async function discoverAgents(options) {
             agents.set(definition.name, definition);
     };
     for (const [name, spec] of Object.entries(options.cli ?? {})) {
-        const { definition, warnings: w } = parseAgentDefinition(`---\n${JSON.stringify({ name, description: spec.description, ...(spec.tools ? { tools: spec.tools } : {}), ...(spec.model ? { model: spec.model } : {}) })}\n---\n${spec.prompt ?? ""}`, { source: "cli" });
+        const { definition, warnings: w } = parseAgentDefinition(`---\n${JSON.stringify({
+            name,
+            description: spec.description,
+            ...(spec.tools ? { tools: spec.tools } : {}),
+            ...(spec.model ? { model: spec.model } : {}),
+            ...(spec.mode ? { mode: spec.mode } : {}),
+        })}\n---\n${spec.prompt ?? ""}`, { source: "cli" });
         warnings.push(...w);
         if (definition)
             add(definition);
@@ -236,6 +249,7 @@ export async function discoverAgents(options) {
         { dir: join(options.workspace, ".opencode", "agent"), source: "compat", project: true },
         { dir: join(options.workspace, ".opencode", "agents"), source: "compat", project: true },
         { dir: join(options.configHome, "agents"), source: "user", project: false },
+        { dir: join(options.home, ".agents", "agents"), source: "user", project: false },
         { dir: join(options.home, ".claude", "agents"), source: "user", project: false },
         { dir: join(options.home, ".config", "opencode", "agent"), source: "user", project: false },
         { dir: join(options.home, ".config", "opencode", "agents"), source: "user", project: false },

package/dist/index.d.ts

@@ -2,6 +2,10 @@ import { type Plugin } from "@alisio/sdk";
 export type { AgentDefinition } from "./definitions.ts";
 export { BUILTIN_AGENTS, discoverAgents, parseAgentDefinition } from "./definitions.ts";
 export { SubagentManager } from "./manager.ts";
+/** Plugin-state key under which the plugin publishes main-session-capable (mode primary/all) agents. */
+export declare const MAIN_AGENTS_STATE_KEY = "mainAgents";
+/** Plugin-state key listing every loaded definition (name, mode, source, path). */
+export declare const DEFINITIONS_STATE_KEY = "definitions";
 export interface SubagentsPluginContext {
     workspace: string;
     stateHome: string;

package/dist/index.js

@@ -11,6 +11,10 @@ import { SubagentManager } from "./manager.js";
 import { loadVersion } from "./version.js";
 export { BUILTIN_AGENTS, discoverAgents, parseAgentDefinition } from "./definitions.js";
 export { SubagentManager } from "./manager.js";
+/** Plugin-state key under which the plugin publishes main-session-capable (mode primary/all) agents. */
+export const MAIN_AGENTS_STATE_KEY = "mainAgents";
+/** Plugin-state key listing every loaded definition (name, mode, source, path). */
+export const DEFINITIONS_STATE_KEY = "definitions";
 const schema = (properties, required) => ({
     type: "object",
     properties,
@@ -34,25 +38,54 @@ export function createSubagentsPlugin(rawOptions, context) {
         id: "subagents",
         name: "Subagents",
         description: "Delegation to specialized agents in isolated child sessions",
+        categories: ["subagents"],
         version: loadVersion(import.meta.url),
         apiVersion: 1,
         async setup(api) {
-            const found = await discoverAgents({
-                workspace: context.workspace,
-                home: context.home,
-                configHome: context.configHome,
-                trusted: context.trusted,
-                cli: config.agents,
-                plugins: api.resources.list("agents"),
-            });
-            warnings = found.warnings;
+            /**
+             * Discovers the definitions and publishes them: the main-session-capable ones (mode
+             * `primary`/`all`) for the host's ACTIVE-agent catalog, and every loaded file path so the
+             * host can tell whether a just-saved agent file is live. The host reads both through
+             * `pluginState`, so it never imports this package. Prompts stay bounded.
+             */
+            const load = async () => {
+                const found = await discoverAgents({
+                    workspace: context.workspace,
+                    home: context.home,
+                    configHome: context.configHome,
+                    trusted: context.trusted,
+                    cli: config.agents,
+                    plugins: api.resources.list("agents"),
+                });
+                warnings = found.warnings;
+                api.state.set(MAIN_AGENTS_STATE_KEY, [...found.agents.values()]
+                    .filter((a) => a.mode !== "subagent" && !a.hidden)
+                    .map((a) => ({
+                    name: a.name,
+                    description: a.description,
+                    prompt: a.prompt.slice(0, 24_000),
+                    ...(a.model ? { model: a.model } : {}),
+                    ...(a.readOnly ? { readOnly: true } : {}),
+                    ...(a.effort ? { effort: a.effort } : {}),
+                    source: a.source,
+                    ...(a.path ? { path: a.path } : {}),
+                })));
+                api.state.set(DEFINITIONS_STATE_KEY, [...found.agents.values()].map((a) => ({
+                    name: a.name,
+                    mode: a.mode,
+                    source: a.source,
+                    ...(a.path ? { path: a.path } : {}),
+                })));
+                return found;
+            };
+            const found = await load();
             const m = new SubagentManager(api, config, context, found.agents);
             manager = m;
             const status = () => {
                 const all = [...m.tasks.values()];
                 const running = all.filter((t) => t.status === "running").length;
                 const queued = all.filter((t) => t.status === "queued").length;
-                api.ui.status("agents", running || queued ? `agents ${running}▶${queued ? ` ${queued}⧗` : ""}` : undefined, `${all.length} subagent task(s) this process · ${running} running · ${queued} queued · ${found.agents.size} definitions`);
+                api.ui.status("agents", running || queued ? `agents ${running}▶${queued ? ` ${queued}⧗` : ""}` : undefined, `${all.length} subagent task(s) this process · ${running} running · ${queued} queued · ${m.agents.size} definitions`);
             };
             m.refresh = status;
             api.events.on((event) => {
@@ -187,6 +220,16 @@ export function createSubagentsPlugin(rawOptions, context) {
                                 "`/agents open|cancel|kill|resume <id>` · `/agents merge|discard <id>` (worktrees) · `/agents defs`",
                             ].join("\n");
                         }
+                        case "reload": {
+                            // Hot-reload after agent files change (the host calls this after each save).
+                            // Running tasks keep their definition; new delegations and the ACTIVE-agent
+                            // catalog use the rediscovered set. The `task` tool's description (its list of
+                            // advertised subagent types) is fixed at startup.
+                            const reloaded = await load();
+                            m.agents = reloaded.agents;
+                            status();
+                            return `Reloaded ${reloaded.agents.size} agent definitions${reloaded.warnings.length ? ` (${reloaded.warnings.length} warnings, see /agents defs)` : ""}.`;
+                        }
                         case "defs":
                             return [
                                 "**Agent definitions**",
@@ -231,7 +274,7 @@ export function createSubagentsPlugin(rawOptions, context) {
                             return `Discarded ${wt.branch} and removed its worktree.`;
                         }
                         default:
-                            return "Usage: /agents [list|defs|open|cancel|kill|resume|merge|discard] [id]";
+                            return "Usage: /agents [list|defs|reload|open|cancel|kill|resume|merge|discard] [id]";
                     }
                 }
                 catch (error) {
@@ -239,7 +282,7 @@ export function createSubagentsPlugin(rawOptions, context) {
                 }
             }, {
                 description: "List and manage subagents (open, cancel, resume, merge, discard, defs)",
-                argumentHint: "[open|cancel|kill|resume|merge|discard|defs] [id]",
+                argumentHint: "[open|cancel|kill|resume|merge|discard|defs|reload] [id]",
             });
             status();
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/plugin-subagents",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0",
   "description": "Subagents for Alisio: delegate tasks to specialized agents in separate child sessions with narrowed permissions, parallel execution, git worktree isolation and a live agent tree. Built-in, disableable plugin.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",
@@ -46,10 +46,10 @@
     "zod": "4.6.5"
   },
   "peerDependencies": {
-    "@alisio/sdk": "^0.1.0-alpha.7"
+    "@alisio/sdk": "^0.1.0"
   },
   "devDependencies": {
-    "@alisio/sdk": "0.1.0-alpha.7"
+    "@alisio/sdk": "0.1.0"
   },
   "publishConfig": {
     "access": "public",