From 06bc18bad8fc38d966e2617b5ee58bcd3b9b33ba Mon Sep 17 00:00:00 2001
From: Marius Iversen <marius.iversen@elastic.co>
Date: Fri, 29 Nov 2024 15:59:17 +0100
Subject: [PATCH] [Rules Migration] Add yarn command to draw graphs (#201753)

## Summary

This PR implements a simple yarn command that is identical to the ones
used in Elastic Assistant and Automatic Import, which draws the relevant
Langgraph components used and places them in the docs folder under the
correct subfolder.

It also adds a tiny unit test to only ensure that the graph compiles
itself, which can be easy to miss during smaller fixes to the graph.

This is meant to be run manually and is not part of any CI process, but
provides benefits to navigate graphs when they become more complex.
---
 .../docs/siem_migration/README.md             |  17 ++++
 .../docs/siem_migration/img/agent_graph.png   | Bin 0 -> 23303 bytes
 x-pack/plugins/security_solution/package.json |   3 +-
 .../scripts/siem_migration/draw_graphs.js     |   9 ++
 .../siem_migration/draw_graphs_script.ts      |  80 ++++++++++++++++++
 .../rules/task/agent/graph.test.ts            |  47 ++++++++++
 .../siem_migrations/rules/task/agent/graph.ts |   8 +-
 7 files changed, 159 insertions(+), 5 deletions(-)
 create mode 100644 x-pack/plugins/security_solution/docs/siem_migration/README.md
 create mode 100644 x-pack/plugins/security_solution/docs/siem_migration/img/agent_graph.png
 create mode 100644 x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs.js
 create mode 100644 x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs_script.ts
 create mode 100644 x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.test.ts

diff --git a/x-pack/plugins/security_solution/docs/siem_migration/README.md b/x-pack/plugins/security_solution/docs/siem_migration/README.md
new file mode 100644
index 0000000000000..84a2d17277ec4
--- /dev/null
+++ b/x-pack/plugins/security_solution/docs/siem_migration/README.md
@@ -0,0 +1,17 @@
+# SIEM Migration Library
+
+## Migration Process
+
+The SIEM migration library defines a set of UI components and services that are used to migrate third party SIEM resources like detection rules and translate them into resources that can be used in the Elastic Security app.
+
+## Graphs:
+
+The below images are generated by running the following command from the security_solution directory:
+
+```bash
+yarn siem-migrations:graph:draw
+```
+
+Main agent graph:
+
+![Agent Graph](./img/agent_graph.png)
\ No newline at end of file
diff --git a/x-pack/plugins/security_solution/docs/siem_migration/img/agent_graph.png b/x-pack/plugins/security_solution/docs/siem_migration/img/agent_graph.png
new file mode 100644
index 0000000000000000000000000000000000000000..a4039ef4a74461e37c9be915583e62af447d3a1c
GIT binary patch
literal 23303
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
ZUF0%$1-tB##14S|)olE4Wzt^;{{a(hRtNw9

literal 0
HcmV?d00001

diff --git a/x-pack/plugins/security_solution/package.json b/x-pack/plugins/security_solution/package.json
index 62a406960ceeb..fd1be833c5d6b 100644
--- a/x-pack/plugins/security_solution/package.json
+++ b/x-pack/plugins/security_solution/package.json
@@ -27,6 +27,7 @@
     "test:generate:serverless-dev": "NODE_TLS_REJECT_UNAUTHORIZED=0 node --no-warnings scripts/endpoint/resolver_generator --node https://elastic_serverless:changeme@127.0.0.1:9200 --kibana http://elastic_serverless:changeme@127.0.0.1:5601",
     "mappings:generate": "node scripts/mappings/mappings_generator",
     "mappings:load": "node scripts/mappings/mappings_loader",
+    "siem-migrations:graph:draw": "node scripts/siem_migration/draw_graphs",
     "junit:transform": "node scripts/junit_transformer --pathPattern '../../../target/kibana-security-solution/cypress/results/*.xml' --rootDirectory ../../../ --reportName 'Security Solution Cypress' --writeInPlace",
     "openapi:generate": "node scripts/openapi/generate",
     "openapi:generate:debug": "node --inspect-brk scripts/openapi/generate",
@@ -35,4 +36,4 @@
     "openapi:bundle:entity-analytics": "node scripts/openapi/bundle_entity_analytics",
     "openapi:bundle:endpoint-management": "node scripts/openapi/bundle_endpoint_management"
   }
-}
+}
\ No newline at end of file
diff --git a/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs.js b/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs.js
new file mode 100644
index 0000000000000..010b6c15f323c
--- /dev/null
+++ b/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs.js
@@ -0,0 +1,9 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+require('../../../../../src/setup_node_env');
+require('./draw_graphs_script').draw();
diff --git a/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs_script.ts b/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs_script.ts
new file mode 100644
index 0000000000000..4cb2b5c740474
--- /dev/null
+++ b/x-pack/plugins/security_solution/scripts/siem_migration/draw_graphs_script.ts
@@ -0,0 +1,80 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { InferenceClient } from '@kbn/inference-plugin/server';
+import type {
+  ActionsClientChatOpenAI,
+  ActionsClientSimpleChatModel,
+} from '@kbn/langchain/server/language_models';
+import type { Logger } from '@kbn/logging';
+import { ToolingLog } from '@kbn/tooling-log';
+import { FakeLLM } from '@langchain/core/utils/testing';
+import fs from 'fs/promises';
+import path from 'path';
+import { getRuleMigrationAgent } from '../../server/lib/siem_migrations/rules/task/agent';
+import type { IntegrationRetriever } from '../../server/lib/siem_migrations/rules/task/util/integration_retriever';
+import type { PrebuiltRulesMapByName } from '../../server/lib/siem_migrations/rules/task/util/prebuilt_rules';
+import type { RuleResourceRetriever } from '../../server/lib/siem_migrations/rules/task/util/rule_resource_retriever';
+
+interface Drawable {
+  drawMermaidPng: () => Promise<Blob>;
+}
+
+const mockLlm = new FakeLLM({
+  response: JSON.stringify({}, null, 2),
+}) as unknown as ActionsClientChatOpenAI | ActionsClientSimpleChatModel;
+
+const inferenceClient = {} as InferenceClient;
+const connectorId = 'draw_graphs';
+const prebuiltRulesMap = {} as PrebuiltRulesMapByName;
+const resourceRetriever = {} as RuleResourceRetriever;
+const integrationRetriever = {} as IntegrationRetriever;
+
+const createLlmInstance = () => {
+  return mockLlm;
+};
+
+async function getAgentGraph(logger: Logger): Promise<Drawable> {
+  const model = createLlmInstance();
+  const graph = getRuleMigrationAgent({
+    model,
+    inferenceClient,
+    prebuiltRulesMap,
+    resourceRetriever,
+    integrationRetriever,
+    connectorId,
+    logger,
+  });
+  return graph.getGraphAsync({ xray: true });
+}
+
+export const drawGraph = async ({
+  getGraphAsync,
+  outputFilename,
+}: {
+  getGraphAsync: (logger: Logger) => Promise<Drawable>;
+  outputFilename: string;
+}) => {
+  const logger = new ToolingLog({
+    level: 'info',
+    writeTo: process.stdout,
+  }) as unknown as Logger;
+  logger.info('Compiling graph');
+  const outputPath = path.join(__dirname, outputFilename);
+  const graph = await getGraphAsync(logger);
+  const output = await graph.drawMermaidPng();
+  const buffer = Buffer.from(await output.arrayBuffer());
+  logger.info(`Writing graph to ${outputPath}`);
+  await fs.writeFile(outputPath, buffer);
+};
+
+export const draw = async () => {
+  await drawGraph({
+    getGraphAsync: getAgentGraph,
+    outputFilename: '../../docs/siem_migration/img/agent_graph.png',
+  });
+};
diff --git a/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.test.ts b/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.test.ts
new file mode 100644
index 0000000000000..eece827726a33
--- /dev/null
+++ b/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.test.ts
@@ -0,0 +1,47 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { InferenceClient } from '@kbn/inference-plugin/server';
+import type {
+  ActionsClientChatOpenAI,
+  ActionsClientSimpleChatModel,
+} from '@kbn/langchain/server/language_models';
+import { loggerMock } from '@kbn/logging-mocks';
+import { FakeLLM } from '@langchain/core/utils/testing';
+import type { IntegrationRetriever } from '../util/integration_retriever';
+import type { PrebuiltRulesMapByName } from '../util/prebuilt_rules';
+import type { RuleResourceRetriever } from '../util/rule_resource_retriever';
+import { getRuleMigrationAgent } from './graph';
+
+describe('getRuleMigrationAgent', () => {
+  const model = new FakeLLM({
+    response: JSON.stringify({}, null, 2),
+  }) as unknown as ActionsClientChatOpenAI | ActionsClientSimpleChatModel;
+
+  const inferenceClient = {} as InferenceClient;
+  const connectorId = 'draw_graphs';
+  const prebuiltRulesMap = {} as PrebuiltRulesMapByName;
+  const resourceRetriever = {} as RuleResourceRetriever;
+  const integrationRetriever = {} as IntegrationRetriever;
+  const logger = loggerMock.create();
+
+  it('Ensures that the graph compiles', async () => {
+    try {
+      await getRuleMigrationAgent({
+        model,
+        inferenceClient,
+        prebuiltRulesMap,
+        resourceRetriever,
+        integrationRetriever,
+        connectorId,
+        logger,
+      });
+    } catch (error) {
+      throw Error(`getRuleMigrationAgent threw an error: ${error}`);
+    }
+  });
+});
diff --git a/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.ts b/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.ts
index 078b3ffdcdcb4..4f2d2a74ff611 100644
--- a/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.ts
+++ b/x-pack/plugins/security_solution/server/lib/siem_migrations/rules/task/agent/graph.ts
@@ -30,16 +30,16 @@ export function getRuleMigrationAgent({
     logger,
   });
 
-  const translateRuleGraph = new StateGraph(migrateRuleState)
+  const siemMigrationAgentGraph = new StateGraph(migrateRuleState)
     // Nodes
     .addNode('matchPrebuiltRule', matchPrebuiltRuleNode)
-    .addNode('translation', translationSubGraph)
+    .addNode('translationSubGraph', translationSubGraph)
     // Edges
     .addEdge(START, 'matchPrebuiltRule')
     .addConditionalEdges('matchPrebuiltRule', matchedPrebuiltRuleConditional)
-    .addEdge('translation', END);
+    .addEdge('translationSubGraph', END);
 
-  const graph = translateRuleGraph.compile();
+  const graph = siemMigrationAgentGraph.compile();
   graph.name = 'Rule Migration Graph'; // Customizes the name displayed in LangSmith
   return graph;
 }