@aexol/spectral 0.9.258 → 0.9.259

package/dist/agent/agents.d.ts

@@ -39,11 +39,13 @@ export declare function refreshCloudAgents(opts: {
  * (SYSTEM_AGENTS, read-only) plus cloud agents from the backend cache
  * (refreshCloudAgents, managed in Aexol Studio).
  *
- * Precedence: cloud agents override system agents on name collision, but
- * ALL cloud agents are returned — including same-named subagents that live
- * under different PRIMARY agents (subagent names are no longer globally
- * unique per team; name resolution is parent-aware, see
- * `resolveAgentByName`). Primaries remain unique per team by construction.
+ * Discovery is name-agnostic: ALL agents are returned, including cloud
+ * agents that share a name with a system agent (subagent names are no
+ * longer globally unique per team). Name-collision precedence is applied
+ * at resolution time in `resolveAgentByName` (system agents win in
+ * team-wide mode; a primary's own subtree wins in scoped mode).
+ * Primaries remain unique per team by construction (the backend blocks
+ * reserved system names for cloud primaries).
  * Never throws and never touches the network — offline / logged-out
  * sessions simply get the system agents.
  */
@@ -74,6 +76,17 @@ export type AgentSubtreeRef = Pick<AgentConfig, "id" | "name">;
  * back to team-wide resolution.
  */
 export declare function agentsInSubtree(agents: AgentConfig[], activePrimary?: AgentSubtreeRef | null): AgentConfig[];
+/**
+ * The set of agents a session can actually reach:
+ *
+ * - Scoped (an `activePrimary` cloud primary): the primary's subtree plus
+ *   the built-in system agents — a same-named cloud subagent in the
+ *   subtree intentionally shadows the system agent, so system agents are
+ *   only appended when their name is free in the subtree.
+ * - Team-wide (no active primary): system agents win over same-named
+ *   cloud agents (dedupe keeps the system row, first).
+ */
+export declare function reachableAgents(agents: AgentConfig[], activePrimary?: AgentSubtreeRef | null): AgentConfig[];
 /**
  * Outcome of resolving an agent name against a discovered agent list,
  * optionally scoped to an active primary's subtree.
@@ -93,16 +106,23 @@ export type AgentResolution = {
 /**
  * Resolve an agent name to a single agent.
  *
- * - With an `activePrimary` ref (a cloud primary with a backend id):
+ * - Team-wide (no `activePrimary`, e.g. the built-in ghost session):
+ *   SYSTEM agents always win over same-named cloud agents, so a cloud
+ *   subagent named "executor" can no longer hijack the system executor.
+ *   Only when no system agent has that name does resolution fall through
+ *   to the cloud first-match (historical behavior for team-wide
+ *   duplicates — not an error in fallback mode).
+ * - Scoped (an `activePrimary` cloud primary with a backend id):
  *   candidates are scoped to the primary's subtree (the primary itself +
  *   its direct children, plus any other agent sharing the primary's name),
  *   so same-named subagents under different primaries resolve to the
- *   caller's own subtree. A name that matches multiple agents within the
- *   subtree (legacy data) is ambiguous — the caller must surface the
- *   conflict, never silently pick one.
- * - Without one (standalone session / system primary): team-wide
- *   first-match, exactly the historical behavior (duplicates across the
- *   team are not an error in fallback mode).
+ *   caller's own subtree. A same-named cloud subagent in the subtree
+ *   intentionally shadows the system agent (that primary's own
+ *   "executor"). If the name is NOT in the subtree, resolution falls back
+ *   to SYSTEM agents (never to cloud agents of other trees). A name that
+ *   matches multiple agents within the subtree (legacy data) is
+ *   ambiguous — the caller must surface the conflict, never silently
+ *   pick one.
  */
 export declare function resolveAgentByName(name: string, agents: AgentConfig[], activePrimary?: AgentSubtreeRef | null): AgentResolution;
 /**

package/dist/agent/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"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"}

package/dist/agent/agents.js

@@ -219,22 +219,19 @@ export async function refreshCloudAgents(opts) {
  * (SYSTEM_AGENTS, read-only) plus cloud agents from the backend cache
  * (refreshCloudAgents, managed in Aexol Studio).
  *
- * Precedence: cloud agents override system agents on name collision, but
- * ALL cloud agents are returned — including same-named subagents that live
- * under different PRIMARY agents (subagent names are no longer globally
- * unique per team; name resolution is parent-aware, see
- * `resolveAgentByName`). Primaries remain unique per team by construction.
+ * Discovery is name-agnostic: ALL agents are returned, including cloud
+ * agents that share a name with a system agent (subagent names are no
+ * longer globally unique per team). Name-collision precedence is applied
+ * at resolution time in `resolveAgentByName` (system agents win in
+ * team-wide mode; a primary's own subtree wins in scoped mode).
+ * Primaries remain unique per team by construction (the backend blocks
+ * reserved system names for cloud primaries).
  * Never throws and never touches the network — offline / logged-out
  * sessions simply get the system agents.
  */
 export function discoverAgents(teamId) {
     const cloudAgents = getCloudAgentCache(teamId ?? LEGACY_CLOUD_TEAM).agents;
-    const cloudNames = new Set(cloudAgents.map((a) => a.name));
-    return [
-        // System agents survive only when no cloud agent shadows their name.
-        ...SYSTEM_AGENTS.filter((a) => !cloudNames.has(a.name)),
-        ...cloudAgents,
-    ];
+    return [...SYSTEM_AGENTS, ...cloudAgents];
 }
 export function discoverPrimaryAgent(teamId) {
     const agents = discoverAgents(teamId);
@@ -242,8 +239,9 @@ export function discoverPrimaryAgent(teamId) {
     if (primaries.length === 0)
         return null;
     if (primaries.length > 1) {
-        // Cloud agents override built-in system agents (same precedence as
-        // discovery): a cloud primary always wins over the built-in ghost.
+        // A cloud primary always wins over the built-in ghost. (Cloud
+        // primaries cannot use reserved system names — the backend blocks
+        // it — so this only fires for a genuine primary-selection override.)
         const cloudPrimary = primaries.find((a) => a.source === "cloud");
         const chosen = cloudPrimary ?? primaries[0];
         console.warn(chalk.yellow(`Multiple primary agents found (${primaries.map((a) => a.name).join(", ")}). Using "${chosen.name}".`));
@@ -287,19 +285,52 @@ export function agentsInSubtree(agents, activePrimary) {
         (activePrimary.id !== undefined &&
             (a.id === activePrimary.id || a.parentId === activePrimary.id)));
 }
+/**
+ * The set of agents a session can actually reach:
+ *
+ * - Scoped (an `activePrimary` cloud primary): the primary's subtree plus
+ *   the built-in system agents — a same-named cloud subagent in the
+ *   subtree intentionally shadows the system agent, so system agents are
+ *   only appended when their name is free in the subtree.
+ * - Team-wide (no active primary): system agents win over same-named
+ *   cloud agents (dedupe keeps the system row, first).
+ */
+export function reachableAgents(agents, activePrimary) {
+    if (!activePrimary) {
+        const systemAgents = agents.filter((a) => a.source === "system");
+        const systemNames = new Set(systemAgents.map((a) => a.name));
+        return [
+            ...systemAgents,
+            ...agents.filter((a) => a.source !== "system" && !systemNames.has(a.name)),
+        ];
+    }
+    const subtree = agentsInSubtree(agents, activePrimary);
+    const subtreeNames = new Set(subtree.map((a) => a.name));
+    return [
+        ...subtree,
+        ...agents.filter((a) => a.source === "system" && !subtreeNames.has(a.name)),
+    ];
+}
 /**
  * Resolve an agent name to a single agent.
  *
- * - With an `activePrimary` ref (a cloud primary with a backend id):
+ * - Team-wide (no `activePrimary`, e.g. the built-in ghost session):
+ *   SYSTEM agents always win over same-named cloud agents, so a cloud
+ *   subagent named "executor" can no longer hijack the system executor.
+ *   Only when no system agent has that name does resolution fall through
+ *   to the cloud first-match (historical behavior for team-wide
+ *   duplicates — not an error in fallback mode).
+ * - Scoped (an `activePrimary` cloud primary with a backend id):
  *   candidates are scoped to the primary's subtree (the primary itself +
  *   its direct children, plus any other agent sharing the primary's name),
  *   so same-named subagents under different primaries resolve to the
- *   caller's own subtree. A name that matches multiple agents within the
- *   subtree (legacy data) is ambiguous — the caller must surface the
- *   conflict, never silently pick one.
- * - Without one (standalone session / system primary): team-wide
- *   first-match, exactly the historical behavior (duplicates across the
- *   team are not an error in fallback mode).
+ *   caller's own subtree. A same-named cloud subagent in the subtree
+ *   intentionally shadows the system agent (that primary's own
+ *   "executor"). If the name is NOT in the subtree, resolution falls back
+ *   to SYSTEM agents (never to cloud agents of other trees). A name that
+ *   matches multiple agents within the subtree (legacy data) is
+ *   ambiguous — the caller must surface the conflict, never silently
+ *   pick one.
  */
 export function resolveAgentByName(name, agents, activePrimary) {
     const scope = agentsInSubtree(agents, activePrimary);
@@ -307,13 +338,26 @@ export function resolveAgentByName(name, agents, activePrimary) {
     if (matches.length === 1)
         return { status: "ok", agent: matches[0] };
     if (matches.length > 1 && !activePrimary) {
-        // Fallback mode: historical team-wide first-match. Duplicates across
-        // the team are only an error inside a scoped subtree.
-        return { status: "ok", agent: matches[0] };
+        // Team-wide: a system agent always beats same-named cloud agents;
+        // otherwise keep the historical first-match. Duplicates across the
+        // team are only an error inside a scoped subtree.
+        const systemMatch = matches.find((a) => a.source === "system");
+        return { status: "ok", agent: systemMatch ?? matches[0] };
     }
     if (matches.length > 1)
         return { status: "ambiguous", name, conflicting: matches };
-    return { status: "not-found", name, candidates: scope };
+    if (!activePrimary)
+        return { status: "not-found", name, candidates: scope };
+    // Scoped: no match in the subtree — fall back to built-in system
+    // agents (never to cloud agents of other trees).
+    const systemMatch = agents.find((a) => a.source === "system" && a.name === name);
+    if (systemMatch)
+        return { status: "ok", agent: systemMatch };
+    const candidates = [
+        ...scope,
+        ...agents.filter((a) => a.source === "system"),
+    ];
+    return { status: "not-found", name, candidates };
 }
 /**
  * Prepend the primary agent's system prompt above the base system prompt.

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAEX,UAAU,EAEV,SAAS,EAET,MAAM,4BAA4B,CAAC;AAoBpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAKrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,KAAK,WAAW,EAQhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,uCAAuC,CAAC;AAS/C,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AAyGxG;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AAyND;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AAgCD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,CAAC,EAAE,MAAM,GAChB,SAAS,EAAE,CAkDb;AAyBD;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,cAAc,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,wBAAwB,CAAC;AAqF1E,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAC9C,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACtD,IAAI,CAEN;AAmBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC9D,MAAM,CAiBR;AAwnBD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC3D,GACC,IAAI,CAqbN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAEX,UAAU,EAEV,SAAS,EAET,MAAM,4BAA4B,CAAC;AAoBpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAKrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,KAAK,WAAW,EAQhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,uCAAuC,CAAC;AAS/C,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AAyGxG;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AAyND;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AAgCD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,CAAC,EAAE,MAAM,GAChB,SAAS,EAAE,CAkDb;AAyBD;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,cAAc,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,wBAAwB,CAAC;AAqF1E,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAC9C,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACtD,IAAI,CAEN;AAmBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC9D,MAAM,CAiBR;AAwnBD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC3D,GACC,IAAI,CAwbN"}

package/dist/agent/index.js

@@ -37,7 +37,7 @@ import { RETRY_DEFAULT_BASE_DELAY_MS, RETRY_DEFAULT_MAX_RETRIES, RETRY_MAX_BACKO
 import { mutateSystemPrompt } from "../sdk/coding-agent/core/system-prompt-mutator.js";
 import { sleep } from "../sdk/coding-agent/utils/sleep.js";
 import { Type } from "typebox";
-import { discoverAgents, agentMetadataBlock, resolveAgentByName, agentsInSubtree, resolveSelectedPrimaryAgent, } from "./agents.js";
+import { discoverAgents, agentMetadataBlock, resolveAgentByName, reachableAgents, resolveSelectedPrimaryAgent, } from "./agents.js";
 import { loadAgentSettings } from "../server/handlers/agent-settings.js";
 import { buildTpsUsageFields, computeTpsMetrics, } from "../server/agent-bridge/tps-metrics.js";
 import { randomUUID } from "node:crypto";
@@ -1048,9 +1048,12 @@ export default function subagentExtension(ext, opts) {
             const subtree = activePrimaryRef?.id
                 ? activePrimaryRef
                 : null;
-            // Agent listings in error messages are scoped to the same subtree
-            // so the model only sees what it can actually resolve.
-            const visibleAgents = agentsInSubtree(agents, subtree);
+            // Agent listings in error messages reflect the reachable set —
+            // subtree + system agents in scoped mode (a session under a
+            // cloud primary can still delegate to built-in system agents),
+            // system-first dedupe in team-wide mode — so the model only sees
+            // what it can actually resolve.
+            const visibleAgents = reachableAgents(agents, subtree);
             const hasChain = (params.chain?.length ?? 0) > 0;
             const hasTasks = (params.tasks?.length ?? 0) > 0;
             const hasSingle = Boolean(params.agent && params.task);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.258",
+  "version": "0.9.259",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,