Use portable path for OTLP helper guidance (#62940)

Author: Copilot

.github/aw/syntax-agentic.md

@@ -180,6 +180,13 @@ description: Agentic workflow specific frontmatter fields for GitHub Agentic Wor
 
     Every job emits setup and conclusion spans with rich attributes (`gh-aw.job.name`, `gh-aw.workflow.name`, `gh-aw.engine.id`, token usage). All jobs in a run share one trace ID. Dispatched child workflows inherit the parent's trace context via `aw_context`.
 
+    To emit a custom span from a `github-script` step, resolve the helper through `RUNNER_TEMP` rather than a hardcoded `/tmp` path:
+
+    ```javascript
+    const path = require('path');
+    const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
+    ```
+
 - **`runtimes:`** - Runtime environment version overrides (object)
   - Allows customizing runtime versions (e.g., Node.js, Python) or defining new runtimes
   - Runtimes from imported shared workflows are also merged

.github/aw/token-optimization-observability.md

@@ -23,6 +23,13 @@ observability:
 
 Setup, agent, and conclusion spans carry token usage attributes. See [Frontmatter syntax](syntax-agentic.md#agentic-workflow-specific-fields).
 
+When a `github-script` step needs a custom span, load the helper from the portable runner temporary directory:
+
+```javascript
+const path = require('path');
+const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
+```
+
 ### Add AgenticOps token workflows
 
 - `copilot-token-audit` — scheduled audit of token usage across workflows

actions/setup/js/otlp.cjs

@@ -18,7 +18,8 @@
  *
  * Usage (in a `steps:` github-script step inside a shared import):
  *
- *   const otlp = require('/tmp/gh-aw/actions/otlp.cjs');
+ *   const path = require('path');
+ *   const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
  *   const start = Date.now();
  *   // ... do work ...
  *   await otlp.logSpan('my-tool', { 'my-tool.items_processed': 42, 'my-tool.result': 'ok' }, { startMs: start });

docs/src/content/docs/experimental/qmd.md

@@ -132,7 +132,8 @@ steps:
     with:
       script: |
         const fs   = require('fs');
-        const otlp = require('/tmp/gh-aw/actions/otlp.cjs');
+        const path = require('path');
+        const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
 
         // qmd writes index stats to /tmp/gh-aw/qmd/stats.json after indexing.
         let indexSize = 0;

docs/src/content/docs/reference/open-telemetry.mdx

@@ -170,7 +170,8 @@ steps:
     uses: actions/github-script@v8
     with:
       script: |
-        const otlp = require('/tmp/gh-aw/actions/otlp.cjs');
+        const path = require('path');
+        const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
 
         const startMs = Date.now();
         // ... do your tool's work here (e.g. const result = await myTool.run()) ...
@@ -206,7 +207,8 @@ Run the daily report using my-tool results.
 **`logSpan` API**
 
 ```javascript
-const otlp = require('/tmp/gh-aw/actions/otlp.cjs');
+const path = require('path');
+const otlp = require(path.join(process.env.RUNNER_TEMP, 'gh-aw', 'actions', 'otlp.cjs'));
 
 await otlp.logSpan(toolName, attributes, options);
 ```