Function executeToolDescription

src/tools/execute.ts:243–262

* Description for the `execute` tool, including the per-session Cloudflare type * declarations and a multipart Worker-upload example.

(props?: AuthProps)

 * declarations and a multipart Worker-upload example.
 */
function executeToolDescription(props?: AuthProps): string {
  const types = cloudflareTypesForAccount(props)
  const accountSelection = accountSelectionDescription(props)

  return `Execute JavaScript code against the Cloudflare API. First use the 'search' tool to find the right endpoints, then write code using the cloudflare.request() function.

Available in your code:
${types}${accountSelection}

Your code must be an async arrow function that returns the result.

Example: Worker with bindings (requires multipart/form-data):
async () => {
  const code = \`addEventListener('fetch', e => e.respondWith(MY_KV.get('key').then(v => new Response(v || 'none'))));\`;
  const metadata = { body_part: "script", bindings: [{ type: "kv_namespace", name: "MY_KV", namespace_id: "your-kv-id" }] };
  const b = \`--F\${Date.now()}\`;
  const body = [\`--\${b}\`, 'Content-Disposition: form-data; name="metadata"', 'Content-Type: application/json', '', JSON.stringify(metadata), \`--\${b}\`, 'Content-Disposition: form-data; name="script"', 'Content-Type: application/javascript', '', code, \`--\${b}--\`].join("\\r\\n");
  return cloudflare.request({ method: "PUT", path: \`/accounts/\${accountId}/workers/scripts/my-worker\`, body, contentType: \`multipart/form-data; boundary=\${b}\`, rawBody: true });
}`
}

function accountSelectionDescription(props?: AuthProps): string {
  if (!isMultiAccountUser(props)) return ''