From bc28df017f75bf958e40ec4f711c1cfd012ca854 Mon Sep 17 00:00:00 2001 From: bendtherules Date: Thu, 9 Apr 2026 09:59:15 +0530 Subject: [PATCH] docs: clarify ask262Debug usage in engine262 evaluation tool descriptions and add usage example. --- .opencode/tools/ask262-evaluate-in-engine262.ts | 4 +++- src/agent-tools/evaluateInEngine262.ts | 6 +++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/.opencode/tools/ask262-evaluate-in-engine262.ts b/.opencode/tools/ask262-evaluate-in-engine262.ts index 168fda8..d20da28 100644 --- a/.opencode/tools/ask262-evaluate-in-engine262.ts +++ b/.opencode/tools/ask262-evaluate-in-engine262.ts @@ -11,7 +11,9 @@ export default tool({ "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. " + "Returns JSON with importantSections and otherSections arrays. " + "Use this to understand how specific JavaScript operations map to the ECMAScript spec. " + - "You can use ask262Debug.startImportant() and ask262Debug.stopImportant() in the code to mark important sections.", + "ask262Debug is available globally in the execution context (no import needed). " + + "Use ask262Debug.startImportant() and ask262Debug.stopImportant() to mark important sections. " + + "Example: ask262Debug.startImportant(); let x = 1 + 2; ask262Debug.stopImportant();", args: { code: tool.schema .string() diff --git a/src/agent-tools/evaluateInEngine262.ts b/src/agent-tools/evaluateInEngine262.ts index ba082c8..74fb255 100644 --- a/src/agent-tools/evaluateInEngine262.ts +++ b/src/agent-tools/evaluateInEngine262.ts @@ -42,7 +42,11 @@ export function createEvaluateInEngine262Tool() { return new DynamicStructuredTool({ name: "ask262_evaluate_in_engine262", description: - "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. Returns the full marks array as JSON. Useful for understanding how specific JavaScript operations map to the ECMAScript spec.", + "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. " + + "Returns the full marks array as JSON. Useful for understanding how specific JavaScript operations map to the ECMAScript spec. " + + "ask262Debug is available globally in the execution context (no import needed). " + + "Use ask262Debug.startImportant() and ask262Debug.stopImportant() to mark important sections. " + + "Example: ask262Debug.startImportant(); let x = 1 + 2; ask262Debug.stopImportant();", schema: evaluateSchema, func: async ({ code }) => { try {