feat: added global key signature track, global chord progression track, global tempo(BPM) track, and global marker track related tools for AI Agent

src/agent/tools/ReadKeySignatureTool.ts

@@ -0,0 +1,53 @@
+import { BaseTool } from './BaseTool';
+import type { ToolParameter, ToolResult } from './BaseTool';
+import { GlobalTrackType } from '../../core/global-track';
+import { KGKeySignatureRegion } from '../../core/region/KGKeySignatureRegion';
+import { findGlobalTrackByType, getSortedKeySignatureRegions } from '../../util/globalTrackUtil';
+
+export class ReadKeySignatureTool extends BaseTool {
+  readonly name = 'read_key_signature';
+  readonly description = 'Read the key-signature changes from the global Signature track. If no key-signature regions exist, fall back to the project-level key signature and return it at beat 0.';
+
+  readonly parameters: Record<string, ToolParameter> = {};
+
+  override isAvailableInEfficientMode(): boolean {
+    return false;
+  }
+
+  override buildToolResultDisplayContent(_args: Record<string, unknown> | null, toolResult: ToolResult): string | undefined {
+    return this.formatMultilineResult(toolResult.result);
+  }
+
+  override buildToolHistoryContent(_args: Record<string, unknown> | null, toolResult: ToolResult): string | undefined {
+    return toolResult.result;
+  }
+
+  async execute(_params: Record<string, unknown>): Promise<ToolResult> {
+    try {
+      const project = this.getCurrentProject();
+      const track = findGlobalTrackByType(project, GlobalTrackType.Signature);
+      if (!track) {
+        return this.createErrorResult('Signature global track not found');
+      }
+
+      const beatsPerBar = project.getTimeSignature().numerator;
+      const regions = getSortedKeySignatureRegions(track, beatsPerBar)
+        .filter((region): region is KGKeySignatureRegion => region instanceof KGKeySignatureRegion);
+
+      if (regions.length === 0) {
+        return this.createSuccessResult(`[Beat: 0]: ${project.getKeySignature()}`);
+      }
+
+      const result = regions
+        .map(region => `[Beat: ${region.getStartFromBeat()}]: ${region.getKeySignature()}`)
+        .join('\n');
+      return this.createSuccessResult(result);
+    } catch (error) {
+      return this.createErrorResult(`Failed to read key signature: ${error}`);
+    }
+  }
+
+  private formatMultilineResult(result: string): string {
+    return result.replace(/\n/g, '  \n');
+  }
+}