initial

ts/smartagent.tools.base.ts

@@ -0,0 +1,80 @@
+import * as interfaces from './smartagent.interfaces.js';
+
+/**
+ * Abstract base class for tool wrappers
+ * All tool implementations should extend this class
+ */
+export abstract class BaseToolWrapper implements interfaces.IAgentToolWrapper {
+  abstract name: string;
+  abstract description: string;
+  abstract actions: interfaces.IToolAction[];
+
+  protected isInitialized = false;
+
+  /**
+   * Initialize the tool and any required resources
+   */
+  abstract initialize(): Promise<void>;
+
+  /**
+   * Cleanup any resources used by the tool
+   */
+  abstract cleanup(): Promise<void>;
+
+  /**
+   * Execute an action with the given parameters
+   */
+  abstract execute(
+    action: string,
+    params: Record<string, unknown>
+  ): Promise<interfaces.IToolExecutionResult>;
+
+  /**
+   * Generate a human-readable summary of what the action will do
+   * This is used by the Guardian to understand the proposed action
+   */
+  abstract getCallSummary(action: string, params: Record<string, unknown>): string;
+
+  /**
+   * Validate that an action exists for this tool
+   * @throws Error if the action is not valid
+   */
+  protected validateAction(action: string): void {
+    const validAction = this.actions.find((a) => a.name === action);
+    if (!validAction) {
+      const availableActions = this.actions.map((a) => a.name).join(', ');
+      throw new Error(
+        `Unknown action "${action}" for tool "${this.name}". Available actions: ${availableActions}`
+      );
+    }
+  }
+
+  /**
+   * Check if the tool is initialized
+   */
+  protected ensureInitialized(): void {
+    if (!this.isInitialized) {
+      throw new Error(`Tool "${this.name}" is not initialized. Call initialize() first.`);
+    }
+  }
+
+  /**
+   * Get the full tool description including all actions
+   * Used for Driver's tool awareness
+   */
+  public getFullDescription(): string {
+    const actionDescriptions = this.actions
+      .map((a) => `  - ${a.name}: ${a.description}`)
+      .join('\n');
+
+    return `${this.name}: ${this.description}\nActions:\n${actionDescriptions}`;
+  }
+
+  /**
+   * Get the JSON schema for a specific action
+   */
+  public getActionSchema(action: string): Record<string, unknown> | undefined {
+    const actionDef = this.actions.find((a) => a.name === action);
+    return actionDef?.parameters;
+  }
+}