@aexol/spectral 0.9.191 → 0.9.193

package/dist/agent/agents.d.ts

@@ -6,13 +6,14 @@ export interface AgentConfig {
     mode: AgentMode;
     model?: string;
     systemPrompt: string;
-    source: "user" | "project" | "cloud";
+    source: "user" | "project" | "cloud" | "system";
     filePath: string;
 }
 export interface AgentDiscoveryResult {
     agents: AgentConfig[];
     projectAgentsDir: string | null;
 }
+export declare const SYSTEM_AGENTS: AgentConfig[];
 export declare function setCloudAgents(agents: AgentConfig[], teamId?: string): void;
 /**
  * Outcome of a cloud-agent refresh. Lets callers react to auth rejection

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAyDD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAO3E;AACD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,yEAAyE;IACzE,YAAY,EAAE,IAAI,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG;IACF,YAAY,EAAE,KAAK,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2EnC;AAkBD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAkBtB;AACD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,UAAmB,EAC1B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAepB;AACD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAgBpB;AACD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,IAAI,CAChB,WAAW,EACX,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAC7D,GAAG,IAAI,GACP,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CACT,WAAW,EACX,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAC7D,GAAG,IAAI,GACP,MAAM,CAcR"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAyCtC,CAAC;AA0DF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAO3E;AACD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,yEAAyE;IACzE,YAAY,EAAE,IAAI,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG;IACF,YAAY,EAAE,KAAK,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6EnC;AAkBD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAmBtB;AACD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,UAAmB,EAC1B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAepB;AACD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAgBpB;AACD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,IAAI,CAChB,WAAW,EACX,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAC7D,GAAG,IAAI,GACP,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CACT,WAAW,EACX,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAC7D,GAAG,IAAI,GACP,MAAM,CAgBR"}

package/dist/agent/agents.js

@@ -3,6 +3,40 @@ import * as path from "node:path";
 import chalk from "chalk";
 import { getAgentDir, parseFrontmatter } from "../sdk/coding-agent/index.js";
 import { classifyGraphqlError, createBackendClient, graphqlErrorMessage, scalars, } from "../generated/graphql-client.js";
+export const SYSTEM_AGENTS = [
+    {
+        name: "ghost",
+        description: "Built-in orchestrator primary agent that delegates work to researcher, executor, and reviewer subagents.",
+        mode: "primary",
+        systemPrompt: "You are ghost, the built-in system orchestrator. Plan the work, then delegate by calling the `subagent` tool with one of your subagents, then integrate the results into a coherent outcome.\n\nYour subagents (call them via the `subagent` tool, e.g. subagent(agent=\"researcher\", task=\"...\")):\n- `researcher` — investigate the codebase, read code and documentation, and report precise, cited findings without making changes.\n- `executor` — implement the requested changes minimally and safely, run verification, and report exactly what changed with evidence.\n- `reviewer` — review proposed or implemented changes for correctness, edge cases, security, and consistency with the codebase.\n\nDelegate the actual work to the appropriate subagent instead of doing it yourself; use `researcher` for research/investigation, `executor` for implementation, and `reviewer` for review.",
+        source: "system",
+        filePath: "system:ghost",
+    },
+    {
+        name: "researcher",
+        description: "Built-in system subagent that researches code, documentation, and context for ghost.",
+        mode: "subagent",
+        systemPrompt: "You are the researcher subagent for ghost. Gather relevant context, read code and documentation, and report precise, cited findings without making changes.",
+        source: "system",
+        filePath: "system:researcher",
+    },
+    {
+        name: "executor",
+        description: "Built-in system subagent that implements changes and runs verification for ghost.",
+        mode: "subagent",
+        systemPrompt: "You are the executor subagent for ghost. Implement the requested changes minimally and safely, run the relevant verification commands, and report exactly what changed and the evidence.",
+        source: "system",
+        filePath: "system:executor",
+    },
+    {
+        name: "reviewer",
+        description: "Built-in system subagent that reviews changes for correctness, safety, and quality for ghost.",
+        mode: "subagent",
+        systemPrompt: "You are the reviewer subagent for ghost. Review the proposed and implemented changes for correctness, edge cases, security, and consistency with the codebase, then report concrete findings and any required fixes.",
+        source: "system",
+        filePath: "system:reviewer",
+    },
+];
 function loadAgentsFromDir(dir, source) {
     const agents = [];
     if (!fs.existsSync(dir))
@@ -86,12 +120,14 @@ export async function refreshCloudAgents(opts) {
                         model: true,
                         mode: true,
                         scope: true,
+                        source: true,
                     },
                 ],
             });
             const fetched = result.agents ?? [];
             const agents = fetched
-                .filter((a) => typeof a.name === "string" &&
+                .filter((a) => a.source !== "SYSTEM" &&
+                typeof a.name === "string" &&
                 typeof a.description === "string" &&
                 typeof a.systemPrompt === "string")
                 .map((a) => ({
@@ -164,6 +200,8 @@ export function discoverAgents(cwd, scope, agentDir, teamId) {
         ? getCloudAgentCache(teamId ?? LEGACY_CLOUD_TEAM).agents
         : [];
     const agentMap = new Map();
+    for (const agent of SYSTEM_AGENTS)
+        agentMap.set(agent.name, agent);
     for (const agent of cloudAgents)
         agentMap.set(agent.name, agent);
     for (const agent of projectAgents)
@@ -242,7 +280,9 @@ export function agentMetadataBlock(agent) {
         ? "cloud backend (managed in Aexol Studio; not a local file)"
         : agent.source === "project"
             ? "project file (.spectral/agents)"
-            : "user file (~/.spectral/agents)";
+            : agent.source === "system"
+                ? "built-in system agent (read-only)"
+                : "user file (~/.spectral/agents)";
     lines.push(`Source: ${sourceLabel}`);
     return `\n\n## Agent metadata\n${lines.map((l) => `- ${l}`).join("\n")}`;
 }

package/dist/generated/zeus/const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../../src/generated/zeus/const.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAkyB5C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAkmC1C,CAAA;AAED,eAAO,MAAM,GAAG;;;;CAIf,CAAA"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../../src/generated/zeus/const.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAkyB5C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAmmC1C,CAAA;AAED,eAAO,MAAM,GAAG;;;;CAIf,CAAA"}

package/dist/generated/zeus/const.js

@@ -782,6 +782,7 @@ export const ReturnTypes = {
         mode: "AgentMode",
         scope: "PresetScope",
         source: "AgentSource",
+        readonly: "Boolean",
         createdAt: "DateTime",
         updatedAt: "DateTime",
         parent: "Agent",

package/dist/generated/zeus/index.d.ts

@@ -735,6 +735,7 @@ export type ValueTypes = {
         mode?: boolean | `@${string}`;
         scope?: boolean | `@${string}`;
         source?: boolean | `@${string}`;
+        readonly?: boolean | `@${string}`;
         createdAt?: boolean | `@${string}`;
         updatedAt?: boolean | `@${string}`;
         parent?: ValueTypes["Agent"];
@@ -3056,6 +3057,7 @@ export type ResolverInputTypes = {
         mode?: boolean | `@${string}`;
         scope?: boolean | `@${string}`;
         source?: boolean | `@${string}`;
+        readonly?: boolean | `@${string}`;
         createdAt?: boolean | `@${string}`;
         updatedAt?: boolean | `@${string}`;
         parent?: ResolverInputTypes["Agent"];
@@ -5284,6 +5286,7 @@ export type ModelTypes = {
         mode: ModelTypes["AgentMode"];
         scope: ModelTypes["PresetScope"];
         source: ModelTypes["AgentSource"];
+        readonly: boolean;
         createdAt: ModelTypes["DateTime"];
         updatedAt: ModelTypes["DateTime"];
         parent?: ModelTypes["Agent"] | undefined | null;
@@ -6984,6 +6987,7 @@ export type GraphQLTypes = {
         mode: GraphQLTypes["AgentMode"];
         scope: GraphQLTypes["PresetScope"];
         source: GraphQLTypes["AgentSource"];
+        readonly: boolean;
         createdAt: GraphQLTypes["DateTime"];
         updatedAt: GraphQLTypes["DateTime"];
         parent?: GraphQLTypes["Agent"] | undefined | null;