From baf097f4973757285eaeff8eea8717a09d622c92 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek Date: Sun, 8 Nov 2026 03:31:05 -0800 Subject: [PATCH 1/3] docs(tracing): add zero-code Node.js setup guide Add a discoverable guide for the published auto package, with real trace media and executable snippet, privacy, diagnostic and browser checks. Co-Authored-By: Claude Code --- .github/workflows/auto-node-docs.yml | 38 ++++ package.json | 2 +- .../integrations/traceai/auto/trace-span.png | Bin 0 -> 100550 bytes scripts/auto-links.mjs | 23 ++ scripts/auto-page.test.mjs | 52 +++++ scripts/auto-snippets.mjs | 151 +++++++++++++ scripts/auto.browser.mjs | 65 ++++++ scripts/integrations.test.mjs | 1 + src/lib/integrations.mjs | 1 + src/pages/docs/integrations/traceai/auto.mdx | 199 ++++++++++++++++++ src/pages/docs/integrations/traceai/index.mdx | 8 + .../docs/quickstart/setup-observability.mdx | 4 + 12 files changed, 543 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/auto-node-docs.yml create mode 100644 public/images/docs/integrations/traceai/auto/trace-span.png create mode 100644 scripts/auto-links.mjs create mode 100644 scripts/auto-page.test.mjs create mode 100644 scripts/auto-snippets.mjs create mode 100644 scripts/auto.browser.mjs create mode 100644 src/pages/docs/integrations/traceai/auto.mdx diff --git a/.github/workflows/auto-node-docs.yml b/.github/workflows/auto-node-docs.yml new file mode 100644 index 000000000..af6f4b6b7 --- /dev/null +++ b/.github/workflows/auto-node-docs.yml @@ -0,0 +1,38 @@ +name: Zero-code Node docs + +on: + pull_request: + branches: [main, dev] + paths: + - 'src/pages/docs/integrations/traceai/auto.mdx' + - 'scripts/auto-*.mjs' + - '.github/workflows/auto-node-docs.yml' + workflow_dispatch: + +permissions: + contents: read + +jobs: + published-snippets: + name: Published npm snippets (Node ${{ matrix.node }}) + runs-on: ubuntu-24.04 + timeout-minutes: 15 + strategy: + fail-fast: false + matrix: + node: ['20.6.0', '22.18.0'] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: ${{ matrix.node }} + - name: Audit public reference links and heading anchors + run: node scripts/auto-links.mjs + - name: Run every guide snippet with loopback provider and OTLP + run: node scripts/auto-snippets.mjs + - uses: actions/upload-artifact@v4 + if: always() + with: + name: auto-snippets-${{ matrix.node }} + path: /tmp/docs-auto-evidence + if-no-files-found: error diff --git a/package.json b/package.json index 45b31611e..b03f979d5 100644 --- a/package.json +++ b/package.json @@ -12,7 +12,7 @@ "new-doc": "node scripts/new-doc.mjs", "audit-links": "node scripts/audit-links.mjs", "test:integrations": "node --test scripts/integrations.test.mjs scripts/new-doc.test.mjs scripts/langfuse-import.test.mjs scripts/n8n-page.test.mjs scripts/openlit-endpoint.test.mjs scripts/chromadb-java.test.mjs scripts/openllmetry-content.test.mjs", - "test:integrations:browser": "node scripts/integrations.browser.cjs && node scripts/integrations.regression.cjs && node scripts/widget-regression.cjs", + "test:integrations:browser": "node scripts/integrations.browser.cjs && node scripts/integrations.regression.cjs && node scripts/widget-regression.cjs && node scripts/auto.browser.mjs", "check:integrations": "tsc --allowJs --checkJs --noEmit --strict --types node --target ES2022 --module nodenext src/lib/integrations.mjs" }, "dependencies": { diff --git a/public/images/docs/integrations/traceai/auto/trace-span.png b/public/images/docs/integrations/traceai/auto/trace-span.png new file mode 100644 index 0000000000000000000000000000000000000000..1c4c1eb2fd680112ad111ab49bf27f318f4d7245 GIT binary patch literal 100550 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 SbNY`ZOIm7rs+G#N;r|C|X(#*u literal 0 HcmV?d00001 diff --git a/scripts/auto-links.mjs b/scripts/auto-links.mjs new file mode 100644 index 000000000..c524a89c2 --- /dev/null +++ b/scripts/auto-links.mjs @@ -0,0 +1,23 @@ +// Audit public package references, not signed-in application routes. +import assert from 'node:assert/strict'; +import { readFile } from 'node:fs/promises'; +const page = await readFile(new URL('../src/pages/docs/integrations/traceai/auto.mdx', import.meta.url), 'utf8'); +const urls = new Set([...page.matchAll(/\]\((https:\/\/github\.com\/[^)]+)\)/g)].map(match => match[1])); +const documents = new Map(); +for (const href of urls) { + const url = new URL(href); + const anchor = url.hash.slice(1); + url.hash = ''; + const source = url.href.replace('https://github.com/future-agi/traceAI/blob/', 'https://raw.githubusercontent.com/future-agi/traceAI/'); + if (!documents.has(source)) { + const response = await fetch(source, { signal: AbortSignal.timeout(30000) }); + assert.ok(response.ok, `${source}: ${response.status}`); + documents.set(source, await response.text()); + } + if (anchor && source.startsWith('https://raw.githubusercontent.com/')) { + const headings = [...documents.get(source).matchAll(/^#{1,6} (.+)$/gm)].map(match => match[1].toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, '').replace(/ /g, '-')); + assert.ok(headings.includes(anchor), `${href}: missing heading`); + } + console.log(`OK ${href}`); +} +console.log(JSON.stringify({ externalLinks: urls.size, fetchedDocuments: documents.size })); diff --git a/scripts/auto-page.test.mjs b/scripts/auto-page.test.mjs new file mode 100644 index 000000000..07c4306dd --- /dev/null +++ b/scripts/auto-page.test.mjs @@ -0,0 +1,52 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { readFileSync, existsSync } from 'node:fs'; +import { integrations, integrationNavigation } from '../src/lib/integrations.mjs'; + +const read = path => readFileSync(new URL(`../${path}`, import.meta.url), 'utf8'); +const page = read('src/pages/docs/integrations/traceai/auto.mdx'); +const route = '/docs/integrations/traceai/auto'; + +test('zero-code Node guide is discoverable from the catalog, sidebar and setup paths', () => { + const entry = integrations.find(item => item.id === 'traceai-auto'); + assert.equal(entry?.href, route); + assert.equal(entry?.category, 'frameworks'); + assert.ok(entry?.aliases.includes('@traceai/auto')); + assert.ok(JSON.stringify(integrationNavigation).includes(route)); + for (const file of ['quickstart/setup-observability', 'integrations/traceai/index']) { + assert.ok(read(`src/pages/docs/${file}.mdx`).includes(route)); + } +}); + +test('primary setup preloads a maintained package without app instrumentation', () => { + assert.match(page, /Node\.js 20\.6 or later/); + assert.match(page, /https:\/\/app\.futureagi\.com\/dashboard\/keys/); + assert.match(page, /[\s\S]*/); + for (const command of ['npm install @traceai/auto', 'node --import @traceai/auto/register app.mjs', 'NODE_OPTIONS="--import @traceai/auto/register" npm start', 'node --require @traceai/auto/register app.cjs', 'npx --no-install traceai-auto doctor']) { + assert.ok(page.includes(command), command); + } + const examples = [...page.matchAll(/```javascript\n([\s\S]*?)\n```/g)]; + assert.equal(examples.length, 1); + assert.match(examples[0][1], /import OpenAI from "openai"/); + assert.doesNotMatch(examples[0][1], /traceai|opentelemetry|instrument|register/); + assert.match(page, /Observe → my-ai-app/); + assert.match(page, /zero exit code alone does not prove export health/); +}); + +test('privacy defaults, runtime boundaries and reference links remain explicit', () => { + const setup = page.split('## Try a minimal')[0]; + assert.match(setup, /captured by default/); + for (const flag of ['FI_HIDE_INPUTS=true', 'FI_HIDE_OUTPUTS=true', 'FI_HIDE_ERROR_DETAILS=true']) assert.ok(setup.includes(flag)); + assert.match(page, /PII pattern redaction[^\n]*Off by default/); + assert.match(page, /raising it does not enable base64 image export/); + assert.match(page, /Other exporters retain their own privacy policies/); + assert.match(page, /README\.md#library-coverage/); + for (const anchor of ['nextjs', 'node-server-bundlers', 'aws-lambda-and-short-lived-processes', 'edge-and-browsers']) assert.ok(page.includes(`FRAMEWORKS.md#${anchor}`)); + assert.match(page, /application-owned exporter/); + assert.match(page, /\/docs\/sdk\/tracing\/set-up-tracing/); + assert.doesNotMatch(page, /verified live|PASS\/FAIL|loopback|test harness|E2B|not tested/); + const image = page.match(/!\[[^\]]+\]\((\/images\/[^)]+)\)/)?.[1]; + assert.ok(image); + assert.ok(existsSync(new URL(`../public${image}`, import.meta.url))); + assert.match(page, /OpenAI SDK 7 with openai\/gpt-4\.1-mini through OpenRouter/); +}); diff --git a/scripts/auto-snippets.mjs b/scripts/auto-snippets.mjs new file mode 100644 index 000000000..ad7655d4a --- /dev/null +++ b/scripts/auto-snippets.mjs @@ -0,0 +1,151 @@ +// Execute every fenced block in the guide against published npm packages. +// Run only in a disposable E2B sandbox or CI. No real service credentials needed. +import assert from 'node:assert/strict'; +import { mkdtemp, mkdir, readFile, writeFile, rm } from 'node:fs/promises'; +import { tmpdir } from 'node:os'; +import { join, resolve } from 'node:path'; +import { createServer } from 'node:http'; +import { execFile } from 'node:child_process'; +import { promisify } from 'node:util'; +import { gunzipSync } from 'node:zlib'; + +const exec = promisify(execFile); +const page = await readFile(new URL('../src/pages/docs/integrations/traceai/auto.mdx', import.meta.url), 'utf8'); +const blocks = [...page.matchAll(/```(bash|javascript)\n([\s\S]*?)\n```/g)].map((m, index) => ({ index, language: m[1], code: m[2] })); +assert.equal(blocks.length, 10, 'Every new fenced block needs an execution case'); +const block = prefix => { + const found = blocks.find(b => b.code.startsWith(prefix)); + assert.ok(found, prefix); + return found; +}; +const done = new Set(); +const results = []; +const batches = []; +const requests = []; +const errors = []; +let collectorStatus = 200; +const app = await mkdtemp(join(tmpdir(), 'auto-docs-')); +const output = resolve(process.env.AUTO_EVIDENCE_DIR || '/tmp/docs-auto-evidence'); +await mkdir(output, { recursive: true }); +const server = createServer(async (req, res) => { + try { + const parts = []; + for await (const part of req) parts.push(part); + let raw = Buffer.concat(parts); + if (req.headers['content-encoding'] === 'gzip') raw = gunzipSync(raw); + const data = JSON.parse(raw.toString() || '{}'); + if (req.url === '/v1/chat/completions') { + assert.equal(req.headers.authorization, 'Bearer synthetic-provider-key'); + assert.equal(data.model, 'docs-test-model'); + assert.equal(data.messages[0].content, 'Say hello in one word.'); + requests.push(data); + res.writeHead(200, { 'content-type': 'application/json' }); + res.end(JSON.stringify({ id: 'chatcmpl-docs', object: 'chat.completion', created: 1700000000, model: data.model, choices: [{ index: 0, message: { role: 'assistant', content: 'Hello!' }, finish_reason: 'stop' }], usage: { prompt_tokens: 13, completion_tokens: 3, total_tokens: 16 } })); + } else if (req.url === '/tracer/v1/traces') { + assert.equal(req.headers['x-api-key'], 'synthetic-fi-api-key'); + assert.equal(req.headers['x-secret-key'], 'synthetic-fi-secret-key'); + batches.push(data); + res.writeHead(collectorStatus, { 'content-type': 'application/json' }); + res.end('{}'); + } else { + throw new Error(`Unexpected request route: ${req.url}`); + } + } catch (error) { + errors.push(error.message); + res.writeHead(500, { 'content-type': 'application/json' }); + res.end('{}'); + } +}); +await new Promise(resolve => server.listen(0, '127.0.0.1', resolve)); +const url = `http://127.0.0.1:${server.address().port}`; +// Do not inherit FI credentials, provider keys, preload flags or user profiles. +const env = { + PATH: process.env.PATH, + HOME: join(app, 'home'), + XDG_CONFIG_HOME: join(app, 'config'), + FI_BASE_URL: url, + OPENAI_BASE_URL: `${url}/v1`, + OPENAI_API_KEY: 'synthetic-provider-key', + OPENAI_MODEL: 'docs-test-model', + npm_config_registry: 'https://registry.npmjs.org', + npm_config_update_notifier: 'false', + npm_config_audit: 'false', + npm_config_fund: 'false', +}; +const setup = block('export FI_API_KEY'); +const config = setup.code.replaceAll('your-api-key', 'synthetic-fi-api-key').replaceAll('your-secret-key', 'synthetic-fi-secret-key'); +const allSpans = from => batches.slice(from).flatMap(batch => batch.resourceSpans.flatMap(resource => resource.scopeSpans.flatMap(scope => scope.spans))); +async function run(name, command, { expected = 'model', hidden = false, overrides = {} } = {}) { + const from = batches.length; + const before = requests.length; + const result = await exec('bash', ['-c', `set -euo pipefail\n${config}\n${command}`], { cwd: app, env: { ...env, ...overrides }, timeout: 180000, maxBuffer: 4 * 1024 * 1024 }); + const spans = allSpans(from); + assert.deepEqual(errors, []); + if (expected === 'model') { + assert.equal(requests.length - before, 1, `${name}: provider calls`); + assert.match(result.stdout, /Hello!/); + assert.equal(spans.length, 1, `${name}: exactly one model span, no duplicate wire span`); + const serialized = JSON.stringify(spans); + assert.match(serialized, /docs-test-model/); + assert.match(serialized, /prompt_tokens|token_count\.prompt|input_tokens/); + assert.match(serialized, /completion_tokens|token_count\.completion|output_tokens/); + assert.ok(BigInt(spans[0].endTimeUnixNano) > BigInt(spans[0].startTimeUnixNano)); + assert.match(JSON.stringify(batches.slice(from)), /my-ai-app/); + if (hidden) assert.doesNotMatch(serialized, /Say hello in one word\.|Hello!/); + else { assert.match(serialized, /Say hello in one word\./); assert.match(serialized, /Hello!/); } + assert.doesNotMatch(serialized, /synthetic-(?:fi|provider)/); + } else if (expected === 'doctor') { + const report = JSON.parse(result.stdout); + assert.equal(report.active, true); + assert.equal(report.collector, collectorStatus === 200 ? 'accepted' : 'failed'); + assert.equal(spans.length, 1); + assert.equal(spans[0].name, 'traceai.auto.doctor'); + } else if (expected === 'bootstrap') { + const report = JSON.parse(result.stdout); + assert.ok(report.integrations.some(i => i.name === 'openai' || i.id === 'openai')); + assert.ok(Array.isArray(report.install)); + assert.equal(spans.length, 0); + } + results.push({ name, spans: spans.length, providerCalls: requests.length - before, exitCode: 0 }); + console.log(JSON.stringify(results.at(-1))); + return result; +} +async function execute(prefix, options) { + const selected = block(prefix); + done.add(selected.index); + return run(prefix.split('\n')[0], selected.code, options); +} +try { + await mkdir(env.HOME, { recursive: true }); + await writeFile(join(app, 'package.json'), JSON.stringify({ name: 'auto-docs-example', private: true, scripts: { start: 'node app.mjs' } })); + await execute('npm install @traceai/auto', { expected: 'install' }); + await execute('npm install openai', { expected: 'install' }); + const example = block('import OpenAI'); + assert.doesNotMatch(example.code, /traceai|opentelemetry/); + await writeFile(join(app, 'app.mjs'), example.code); + // The CommonJS startup variant uses an equivalent normal application, no tracing imports. + await writeFile(join(app, 'app.cjs'), `const OpenAI = require('openai');\n(async () => {\n${example.code.split('\n').slice(1).join('\n')}\n})().catch(error => { console.error(error); process.exitCode = 1; });\n`); + done.add(example.index); + done.add(setup.index); // Executed before every shell command with synthetic substitutions. + await execute('node --import'); + await execute('NODE_OPTIONS='); + await execute('node --require'); + await execute('npx --no-install traceai-auto bootstrap', { expected: 'bootstrap' }); + await execute('FI_HIDE_INPUTS=', { hidden: true }); + await execute('npx --no-install traceai-auto doctor', { expected: 'doctor' }); + // Regression: doctor exit code can be zero even when collection fails. + collectorStatus = 400; + await run('doctor rejects collector errors despite exit zero', block('npx --no-install traceai-auto doctor').code, { expected: 'doctor' }); + collectorStatus = 200; + assert.equal(done.size, blocks.length, 'All page blocks executed'); + const packages = {}; + for (const name of ['@traceai/auto', 'openai']) packages[name] = JSON.parse(await readFile(join(app, 'node_modules', name, 'package.json'), 'utf8')).version; + const receipt = { node: process.version, packages, executedBlocks: done.size, totalBlocks: blocks.length, results, scope: 'Synthetic loopback provider and OTLP only; not a live Cloud test.' }; + await writeFile(join(output, 'snippets.json'), JSON.stringify(receipt, null, 2)); + await writeFile(join(output, 'otlp.json'), JSON.stringify(batches, null, 2)); + await writeFile(join(output, 'package-lock.json'), await readFile(join(app, 'package-lock.json'))); + console.log(JSON.stringify(receipt)); +} finally { + await new Promise(resolve => server.close(resolve)); + await rm(app, { recursive: true, force: true }); +} diff --git a/scripts/auto.browser.mjs b/scripts/auto.browser.mjs new file mode 100644 index 000000000..e34ce82ae --- /dev/null +++ b/scripts/auto.browser.mjs @@ -0,0 +1,65 @@ +import assert from 'node:assert/strict'; +import { mkdir, writeFile } from 'node:fs/promises'; +import { chromium } from 'playwright'; + +const base = 'http://127.0.0.1:4321'; +const route = '/docs/integrations/traceai/auto'; +const out = process.env.AUTO_EVIDENCE_DIR || process.env.INTEGRATIONS_EVIDENCE_DIR || '/tmp/docs-integrations-browser/auto'; +await mkdir(out, { recursive: true }); +const browser = await chromium.launch({ headless: true }); +const results = []; +try { + const context = await browser.newContext({ viewport: { width: 1440, height: 1000 }, permissions: ['clipboard-read', 'clipboard-write'] }); + const page = await context.newPage(); + const errors = []; + page.on('pageerror', error => errors.push(error.message)); + assert.equal((await page.goto(base + route, { waitUntil: 'networkidle' })).status(), 200); + await page.getByRole('heading', { name: 'Zero-code Node.js tracing', exact: true }).waitFor(); + assert.equal(await page.locator('.docs-content pre code').count(), 10); + const code = page.locator('.docs-content pre').filter({ hasText: 'npm install @traceai/auto' }); + await code.locator('.copy-button').click(); + assert.equal((await page.evaluate(() => navigator.clipboard.readText())).trim(), 'npm install @traceai/auto'); + const active = page.locator('.integration-sidebar a[aria-current="page"]'); + assert.equal(await active.getAttribute('href'), route); + const image = page.locator('img[src="/images/docs/integrations/traceai/auto/trace-span.png"]'); + await image.scrollIntoViewIfNeeded(); + await image.evaluate(img => img.decode()); + assert.equal(await image.evaluate(img => img.naturalWidth), 1440); + await page.screenshot({ path: `${out}/auto-result.png` }); + await page.evaluate(() => window.scrollTo({ top: 0, behavior: 'instant' })); + await page.screenshot({ path: `${out}/auto-setup.png` }); + await page.screenshot({ path: `${out}/auto-full.png`, fullPage: true }); + for (const href of await page.locator('.docs-content a[href^="#"]').evaluateAll(links => links.map(a => a.getAttribute('href')))) { + assert.equal(await page.locator(href).count(), 1, `Missing local anchor ${href}`); + } + results.push('page, 10 code blocks, copy button, current sidebar item, trace image and anchors'); + for (const source of ['/docs/quickstart/setup-observability', '/docs/integrations/traceai']) { + await page.goto(base + source, { waitUntil: 'networkidle' }); + await page.locator(`.docs-content a[href="${route}"]`).first().click(); + await page.waitForURL(base + route); + await page.getByRole('heading', { name: 'Zero-code Node.js tracing', exact: true }).waitFor(); + } + results.push('quickstart and overview links navigate to the guide'); + await page.goto(base + '/docs/integrations', { waitUntil: 'networkidle' }); + await page.locator('#integration-search').fill('@traceai/auto'); + const card = page.locator('[data-integration-card]:visible'); + await page.waitForFunction(() => document.querySelectorAll('[data-integration-card]:not([hidden])').length === 1); + assert.equal(await card.count(), 1); + assert.equal(await card.getAttribute('href'), route); + await card.click(); + await page.waitForURL(base + route); + results.push('package-name search discovers and opens the guide'); + const search = await page.evaluate(async route => { + const pagefind = await import('/pagefind/pagefind.js'); + const response = await pagefind.search('Zero-code Node.js'); + const entries = await Promise.all(response.results.map(result => result.data())); + return entries.some(entry => entry.url.replace(/\/$/, '') === route); + }, route); + assert.equal(search, true, 'Pagefind indexes the new page'); + results.push('Pagefind search returns the guide'); + assert.deepEqual(errors, []); + await writeFile(`${out}/browser.json`, JSON.stringify({ results, errors }, null, 2)); + console.log(JSON.stringify({ results, errors })); +} finally { + await browser.close(); +} diff --git a/scripts/integrations.test.mjs b/scripts/integrations.test.mjs index 2e745d1e6..d099b0d36 100644 --- a/scripts/integrations.test.mjs +++ b/scripts/integrations.test.mjs @@ -1,3 +1,4 @@ +import './auto-page.test.mjs'; import './pi-plugin-page.test.mjs'; import './openclaw-package-page.test.mjs'; import './goose-page.test.mjs'; diff --git a/src/lib/integrations.mjs b/src/lib/integrations.mjs index 1c01bec88..5f6b2bd97 100644 --- a/src/lib/integrations.mjs +++ b/src/lib/integrations.mjs @@ -26,6 +26,7 @@ export const integrationCategories = [ /** @type {ReadonlyArray} */ export const integrations = [ + { id: 'traceai-auto', name: 'Zero-code Node.js', href: '/docs/integrations/traceai/auto', category: 'frameworks', summary: 'Trace supported Node.js AI calls with one startup preload and no tracing imports.', method: 'traceAI preload', logo: 'generic-framework', aliases: ['@traceai/auto', 'Node.js', 'TypeScript', 'JavaScript', 'zero code', 'auto instrumentation'] }, { id: 'a2a-go', name: 'A2A Go', href: '/docs/integrations/traceai/go/a2a', category: 'frameworks', summary: 'Trace Go agent-to-agent calls on clients and servers.', method: 'traceAI SDK', logo: 'generic-framework' }, { id: 'vitest', name: 'Vitest', href: '/docs/integrations/frameworks/vitest', category: 'frameworks', summary: 'Trace test runs and workers with native OpenTelemetry.', method: 'Native OTLP', logo: 'generic-framework', aliases: ['Vitest tests'] }, { id: 'helicone', name: 'Helicone', href: '/docs/integrations/gateways/helicone', category: 'gateways', summary: 'Trace OpenAI-client calls through a self-hosted Helicone gateway.', method: 'OpenAI client', logo: 'generic-framework' }, diff --git a/src/pages/docs/integrations/traceai/auto.mdx b/src/pages/docs/integrations/traceai/auto.mdx new file mode 100644 index 000000000..37cd73eca --- /dev/null +++ b/src/pages/docs/integrations/traceai/auto.mdx @@ -0,0 +1,199 @@ +--- +title: "Zero-code Node.js tracing" +description: "Trace Node.js AI calls in Future AGI with @traceai/auto. Install once, preload at startup, and inspect model requests, responses, timing and token usage." +--- + +See your Node.js application's AI requests, responses, timing and token usage in Future AGI without adding tracing imports or wrapping model calls. + +## Before you start + +- **Node.js 20.6 or later**, running on the server. The preload does not run in browsers or edge runtimes. +- A Future AGI **API key and secret key** from [API keys](https://app.futureagi.com/dashboard/keys). +- Your model provider's credentials. Future AGI tracing does not supply a model key. + +## Trace your application + +Use your existing app, or start with the [minimal OpenAI example](#try-a-minimal-openai-app) below. + + + + +Run in your application's directory: + +```bash +npm install @traceai/auto +``` + +OpenAI instrumentation and a global-fetch observer are included. Other dedicated integrations are optional; see [supported libraries](#supported-libraries). + + + + +Set both keys in your process environment, preferably through your deployment's secret manager. For a terminal session, replace these placeholders; do not commit credentials: + +```bash +export FI_API_KEY="your-api-key" +export FI_SECRET_KEY="your-secret-key" +export FI_PROJECT_NAME="my-ai-app" +``` + + +Prompts, responses and supported tool content are **captured by default**. Before handling sensitive data, set `FI_HIDE_INPUTS=true`, `FI_HIDE_OUTPUTS=true` and `FI_HIDE_ERROR_DETAILS=true` in the same environment. See [privacy controls](#privacy-controls). + + + + + +Replace `app.mjs` with your application's entry file: + +```bash +node --import @traceai/auto/register app.mjs +``` + +The preload runs before your application imports its AI libraries. Keep your existing provider configuration and application code unchanged. + +**Using an npm start script?** Pass the preload through `NODE_OPTIONS` instead: + +```bash +NODE_OPTIONS="--import @traceai/auto/register" npm start +``` + +Preserve any other Node flags you already use. For a **CommonJS** application, `--import` also works, or use: + +```bash +node --require @traceai/auto/register app.cjs +``` + +Choose one startup method. Do not combine duplicate preloads or manually instrument the same client. Preload each worker or child process you want to trace. + + + + +Make an AI request and consume its response. Open [Future AGI](https://app.futureagi.com), select **Observe → my-ai-app**, then open the model-call span to inspect its inputs, outputs and available usage. + +Completed spans flush when an ordinary Node process exits naturally. For explicit exits or serverless invocations, follow the [flush and lifecycle guidance](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/FRAMEWORKS.md#aws-lambda-and-short-lived-processes); hard termination can lose spans. + + + + +## Try a minimal OpenAI app + +If you do not have an application yet, install the OpenAI SDK alongside `@traceai/auto`: + +```bash +npm install openai +``` + +Set `OPENAI_API_KEY` through your environment and `OPENAI_MODEL` to a model your provider account can use. Save this as **app.mjs**, then run the preload command above: + +```javascript +import OpenAI from "openai"; + +const response = await new OpenAI().chat.completions.create({ + model: process.env.OPENAI_MODEL, + messages: [{ role: "user", content: "Say hello in one word." }], +}); +console.log(response.choices[0].message.content); +``` + +This is ordinary application code—there are no tracing imports. OpenAI SDK versions 4–7 are supported. For an OpenAI-compatible gateway, configure `OPENAI_BASE_URL` and the provider's key and model as usual. + +## What you get + +![OpenAI chat completion in Future AGI with the model, prompt and completion tokens, duration, request body and response body](/images/docs/integrations/traceai/auto/trace-span.png) + +*The example above in the my-ai-app project, using OpenAI SDK 7 with openai/gpt-4.1-mini through OpenRouter.* + +- **Model-call detail:** provider, model, input/output and duration for supported calls. +- **Usage when supplied:** token counts returned by the provider; missing usage is not inferred. Streaming timing depends on the transport. +- **More application context:** installed dedicated integrations can add agent, tool, retrieval or database spans within their supported APIs. +- **OpenTelemetry compatibility:** keep an existing provider, or use an [application-owned exporter](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/CONFIGURATION.md#bring-your-own-opentelemetry-destination). + +This is AI instrumentation, not a general-purpose APM agent: arbitrary functions and non-AI HTTP calls are not automatically traced. The wire observer yields to covered model spans to avoid duplicate capture. + +## Supported libraries + +**Included:** OpenAI library hooks and observation of recognized AI protocols through the process's global `fetch`. Recognition requires a matching endpoint and request shape; not every transport is covered. + +**Optional:** install the dedicated instrumentor alongside its target library for additional coverage. Use the [generated library table](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/README.md#library-coverage) to find the package and setup mode. An import hook, an enable entry and a manual integration are different paths; auto-registration does not expand an integration's supported methods or versions. + +To see detected libraries and suggested packages, without installing anything: + +```bash +npx --no-install traceai-auto bootstrap +``` + +Run from the application directory, then install any suggested instrumentors you need and restart. Libraries reported as `manual` still need their explicit API. See the [transport and capture limits](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/ARCHITECTURE.md) for wire coverage. + +## Privacy controls + +Content capture is **on by default**. To hide inputs, outputs and error details from the first request: + +```bash +FI_HIDE_INPUTS=true FI_HIDE_OUTPUTS=true FI_HIDE_ERROR_DETAILS=true \ +node --import @traceai/auto/register app.mjs +``` + +| Data | Default and control | +| --- | --- | +| Prompts, responses, tool content and transcripts | Captured where supported. Use `FI_HIDE_INPUTS` and `FI_HIDE_OUTPUTS`; granular message and text flags are also available. | +| Error details | Visible unless input/output value, message, text or invocation-parameter hiding implies error hiding. Set `FI_HIDE_ERROR_DETAILS=true` explicitly to hide details. Explicit `false` overrides the derived setting, not secret/media scrubbing. | +| Known credentials and signed URL values | Scrubbed in traceAI's export view. Unknown or transformed secrets may not be recognized; use hide flags for sensitive content. | +| PII pattern redaction | **Off by default.** Enable with `FI_PII_REDACTION=true`; pattern matching is not comprehensive PII detection. | +| Base64 media and raw audio | Recognized payloads are omitted; raw audio bytes are not exported. `FI_BASE64_IMAGE_MAX_LENGTH` defaults to `0`; raising it does not enable base64 image export. | +| Embedding vectors | Catalog wire formats retain dimensions, not vectors. `FI_HIDE_EMBEDDING_VECTORS=true` also hides vectors on library, forwarded and generic-JSON routes. | + +These controls apply to traceAI-authored values and its export view. **Other exporters retain their own privacy policies**; application-owned processors are not silently rewritten. See [all privacy flags and defaults](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/CONFIGURATION.md#privacy-options). + +## Configuration essentials + +Set configuration **before startup** and restart to change it. Later initialization calls do not reconfigure the agent. + +| Variable | Purpose | +| --- | --- | +| `FI_API_KEY`, `FI_SECRET_KEY` | Complete credential pair for the default Future AGI destination. Both must come from the same configuration source. | +| `FI_PROJECT_NAME` | Set an explicit Observe project name for stable routing. | +| `FI_BASE_URL` | Future AGI collector base URL or full traces endpoint. Defaults to `https://api.futureagi.com`. | +| `FI_INSTRUMENTATIONS` | Comma-separated allowlist, such as `openai,wire`. By default, all eligible integrations are considered. | +| `FI_DISABLED_INSTRUMENTATIONS` | Denylist; takes precedence over the allowlist. | +| `FI_WIRE_CAPTURE` | Global-fetch capture and transport credential observation; defaults to `true`. | +| `FI_SAMPLE_RATE` | Root sampling ratio on agent-owned providers; defaults to `1`. Existing providers keep their sampler. | +| `FI_AUTO_DEBUG` | Set to `true` for a masked startup report. | +| `OTEL_SDK_DISABLED` | Set to `true` to disable initialization. | + +Use literal `true` or `false` for boolean settings, not `1` or `0`. The [configuration reference](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/CONFIGURATION.md) covers config files, profiles, precedence and custom OpenTelemetry destinations. + +## Frameworks and deployment + +| Runtime | Setup | +| --- | --- | +| Next.js | Use a guarded `instrumentation.ts` in the Node runtime and keep the agent and target SDKs external. Never expose FI keys as `NEXT_PUBLIC_*`. [Next.js recipe](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/FRAMEWORKS.md#nextjs). | +| esbuild, Vite SSR, Rollup or webpack | Opt into the Node-server adapter; plugins are inactive until configured. Keep AI SDKs external for library hooks and deploy the complete agent payload, not only the entry file. [Bundler recipes](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/FRAMEWORKS.md#node-server-bundlers). | +| AWS Lambda | Initialize once outside the handler and flush at each invocation boundary. Do not rely on process exit or stack duplicate invocation wrappers. [Lambda recipe](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/FRAMEWORKS.md#aws-lambda-and-short-lived-processes). | +| Browser or edge runtime | The Node preload is not supported. The `/edge` subpath is a low-level fetch observer, not a configured tracing SDK. [Edge boundaries](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/FRAMEWORKS.md#edge-and-browsers). | + +## Troubleshooting + +Run diagnostics from the app directory with the same FI environment as your app: + +```bash +npx --no-install traceai-auto doctor +``` + +Doctor sends one test span when enabled. Inspect the JSON `active` and `collector` fields: `accepted` means the collector accepted the test export; `failed` and `not_tested (...)` are not success signals. **A zero exit code alone does not prove export health.** Doctor is a separate process, so its `pending` hooks do not tell you whether your running app has imported a library. + +| Symptom | Next step | +| --- | --- | +| Tracing is disabled | Supply both FI keys in the same source. Check `OTEL_SDK_DISABLED`, the allowlist and denylist. | +| Collector export fails | Check `FI_BASE_URL`, credentials and outbound connectivity. Initialization itself does not probe the collector. | +| `missing_instrumentor` or `manual` | Use bootstrap's suggested package, or the integration's explicit API, then restart. | +| Library remains `pending` | Load the agent before the SDK; check supported versions and keep the SDK external when bundling. | +| No wire span appears | Consume or cancel the response. Direct `undici.fetch`, `node-fetch`, WebSocket and gRPC are not global-fetch capture. Unread responses do not produce completed wire spans. | +| Output is missing or unknown | Check hide flags, the body cap and host OpenTelemetry attribute limits. Truncated or dropped content cannot be reconstructed. | +| Duplicate spans | Remove duplicate preloads or manual instrumentation of the same client; keep one global OpenTelemetry provider and one export route per destination. | + +## When to use manual instrumentation + +Use `@traceai/auto` for supported AI calls with minimal application changes. Choose [fi-core and manual tracing](/docs/sdk/tracing/set-up-tracing) when you need custom parent spans, application-specific attributes or precise control over what is traced. Use an integration's explicit wrapper or processor when its setup mode is `manual`. + +You can add custom spans around automatically traced work, but do not register a second instrumentor for the same client. Browse the [integration guides](/docs/integrations/traceai) for library-specific APIs. diff --git a/src/pages/docs/integrations/traceai/index.mdx b/src/pages/docs/integrations/traceai/index.mdx index eb9996dcb..efe46eb11 100644 --- a/src/pages/docs/integrations/traceai/index.mdx +++ b/src/pages/docs/integrations/traceai/index.mdx @@ -9,6 +9,14 @@ Trace your application by choosing an integration below and following its setup Each guide describes the setup for its integration, including any instrumentation package or native telemetry configuration it requires. +## Start without tracing code + + + + Install `@traceai/auto` and preload at startup to trace supported AI calls without changing application code. + + + ## LLM Providers diff --git a/src/pages/docs/quickstart/setup-observability.mdx b/src/pages/docs/quickstart/setup-observability.mdx index fe6dc0c1a..7b6087b90 100644 --- a/src/pages/docs/quickstart/setup-observability.mdx +++ b/src/pages/docs/quickstart/setup-observability.mdx @@ -11,6 +11,10 @@ Observe supports auto-instrumentation for OpenAI, Anthropic, LangChain, LlamaInd --- + +**Using Node.js or TypeScript?** Start with [zero-code Node.js tracing](/docs/integrations/traceai/auto): install `@traceai/auto` and preload it at startup, without tracing imports or per-call wrappers. Use that path **instead of** the explicit JS/TS instrumentation below; do not instrument the same client twice. + + Install the Future AGI instrumentation package and the OpenAI integration (used in this example). From c8d40204f14c968af62c97ee2c0ab7ca5206285b Mon Sep 17 00:00:00 2001 From: Nikhil Pareek Date: Sun, 8 Nov 2026 03:37:21 -0800 Subject: [PATCH 2/3] test(docs): assert normalized token usage in auto snippets Verify model and token attributes directly instead of allowing raw response content to satisfy usage assertions. Co-Authored-By: Claude Code --- scripts/auto-snippets.mjs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/scripts/auto-snippets.mjs b/scripts/auto-snippets.mjs index ad7655d4a..370818fd3 100644 --- a/scripts/auto-snippets.mjs +++ b/scripts/auto-snippets.mjs @@ -86,9 +86,11 @@ async function run(name, command, { expected = 'model', hidden = false, override assert.match(result.stdout, /Hello!/); assert.equal(spans.length, 1, `${name}: exactly one model span, no duplicate wire span`); const serialized = JSON.stringify(spans); - assert.match(serialized, /docs-test-model/); - assert.match(serialized, /prompt_tokens|token_count\.prompt|input_tokens/); - assert.match(serialized, /completion_tokens|token_count\.completion|output_tokens/); + const attributes = Object.fromEntries(spans[0].attributes.map(attribute => [attribute.key, attribute.value])); + assert.equal(attributes['gen_ai.request.model'].stringValue, 'docs-test-model'); + assert.equal(Number(attributes['gen_ai.usage.input_tokens'].intValue), 13); + assert.equal(Number(attributes['gen_ai.usage.output_tokens'].intValue), 3); + assert.equal(Number(attributes['gen_ai.usage.total_tokens'].intValue), 16); assert.ok(BigInt(spans[0].endTimeUnixNano) > BigInt(spans[0].startTimeUnixNano)); assert.match(JSON.stringify(batches.slice(from)), /my-ai-app/); if (hidden) assert.doesNotMatch(serialized, /Say hello in one word\.|Hello!/); From 9f9907eacc253e3d6c8ccabbd560cc19bff04fa0 Mon Sep 17 00:00:00 2001 From: Nikhil Pareek Date: Sun, 8 Nov 2026 04:17:26 -0800 Subject: [PATCH 3/3] fix(docs): clarify auto HTTP scope and isolate browser checks Document the optional incoming HTTP integration and its denylist switch. Prove both paths against the published package and keep docs UI checks independent of third-party request latency without relaxing their assertions. Co-Authored-By: Claude Code --- package.json | 2 +- scripts/auto-page.test.mjs | 7 +++ scripts/auto-snippets.mjs | 34 +++++++++++++- scripts/auto.browser.mjs | 3 +- scripts/browser-network.browser.cjs | 48 ++++++++++++++++++++ scripts/docs-browser.cjs | 17 +++++++ scripts/integrations.browser.cjs | 9 ++-- scripts/integrations.regression.cjs | 11 +++-- src/pages/docs/integrations/traceai/auto.mdx | 2 +- 9 files changed, 120 insertions(+), 13 deletions(-) create mode 100644 scripts/browser-network.browser.cjs create mode 100644 scripts/docs-browser.cjs diff --git a/package.json b/package.json index b03f979d5..d0131e8fd 100644 --- a/package.json +++ b/package.json @@ -12,7 +12,7 @@ "new-doc": "node scripts/new-doc.mjs", "audit-links": "node scripts/audit-links.mjs", "test:integrations": "node --test scripts/integrations.test.mjs scripts/new-doc.test.mjs scripts/langfuse-import.test.mjs scripts/n8n-page.test.mjs scripts/openlit-endpoint.test.mjs scripts/chromadb-java.test.mjs scripts/openllmetry-content.test.mjs", - "test:integrations:browser": "node scripts/integrations.browser.cjs && node scripts/integrations.regression.cjs && node scripts/widget-regression.cjs && node scripts/auto.browser.mjs", + "test:integrations:browser": "node scripts/browser-network.browser.cjs && node scripts/integrations.browser.cjs && node scripts/integrations.regression.cjs && node scripts/widget-regression.cjs && node scripts/auto.browser.mjs", "check:integrations": "tsc --allowJs --checkJs --noEmit --strict --types node --target ES2022 --module nodenext src/lib/integrations.mjs" }, "dependencies": { diff --git a/scripts/auto-page.test.mjs b/scripts/auto-page.test.mjs index 07c4306dd..423b6adb4 100644 --- a/scripts/auto-page.test.mjs +++ b/scripts/auto-page.test.mjs @@ -33,6 +33,13 @@ test('primary setup preloads a maintained package without app instrumentation', assert.match(page, /zero exit code alone does not prove export health/); }); +test('HTTP scope distinguishes outgoing calls from the optional incoming integration', () => { + assert.match(page, /outgoing non-AI HTTP calls are not automatically traced/); + assert.match(page, /optional `@opentelemetry\/instrumentation-http` package is installed/); + assert.match(page, /incoming HTTP server spans/); + assert.match(page, /`FI_DISABLED_INSTRUMENTATIONS=http` to disable that integration/); +}); + test('privacy defaults, runtime boundaries and reference links remain explicit', () => { const setup = page.split('## Try a minimal')[0]; assert.match(setup, /captured by default/); diff --git a/scripts/auto-snippets.mjs b/scripts/auto-snippets.mjs index 370818fd3..ada978831 100644 --- a/scripts/auto-snippets.mjs +++ b/scripts/auto-snippets.mjs @@ -96,6 +96,14 @@ async function run(name, command, { expected = 'model', hidden = false, override if (hidden) assert.doesNotMatch(serialized, /Say hello in one word\.|Hello!/); else { assert.match(serialized, /Say hello in one word\./); assert.match(serialized, /Hello!/); } assert.doesNotMatch(serialized, /synthetic-(?:fi|provider)/); + } else if (expected === 'http-server' || expected === 'no-http') { + assert.equal(requests.length - before, 0, `${name}: no AI provider call`); + assert.match(result.stdout, /ordinary health response/); + assert.equal(spans.length, expected === 'http-server' ? 1 : 0, `${name}: HTTP span count`); + if (expected === 'http-server') { + assert.equal(spans[0].kind, 2, 'Incoming request exports a SERVER span, not a CLIENT span'); + assert.match(JSON.stringify(spans[0].attributes), /\/health/); + } } else if (expected === 'doctor') { const report = JSON.parse(result.stdout); assert.equal(report.active, true); @@ -140,8 +148,32 @@ try { await run('doctor rejects collector errors despite exit zero', block('npx --no-install traceai-auto doctor').code, { expected: 'doctor' }); collectorStatus = 200; assert.equal(done.size, blocks.length, 'All page blocks executed'); + // Ordinary HTTP is not AI traffic. The optional integration traces only the + // incoming half of this request; no manual tracing APIs are used in the app. + await writeFile(join(app, 'http.mjs'), `import { createServer, get } from 'node:http'; +const server = createServer((request, response) => response.end('ordinary health response')); +await new Promise(resolve => server.listen(0, '127.0.0.1', resolve)); +try { + const body = await new Promise((resolve, reject) => { + get('http://127.0.0.1:' + server.address().port + '/health', response => { + let text = ''; + response.setEncoding('utf8'); + response.on('data', chunk => { text += chunk; }); + response.on('end', () => resolve(text)); + response.on('error', reject); + }).on('error', reject); + }); + console.log(body); +} finally { await new Promise(resolve => server.close(resolve)); } +`); + const httpCommand = block('node --import').code.replace('app.mjs', 'http.mjs'); + await run('HTTP without the optional instrumentor', httpCommand, { expected: 'no-http' }); + await run('install optional HTTP instrumentor', 'npm install @opentelemetry/instrumentation-http@0.202.0', { expected: 'install' }); + await run('HTTP integration captures incoming but not outgoing requests', httpCommand, { expected: 'http-server' }); + assert.ok(page.includes('FI_DISABLED_INSTRUMENTATIONS=http')); + await run('HTTP denylist disables incoming spans', `FI_DISABLED_INSTRUMENTATIONS=http ${httpCommand}`, { expected: 'no-http' }); const packages = {}; - for (const name of ['@traceai/auto', 'openai']) packages[name] = JSON.parse(await readFile(join(app, 'node_modules', name, 'package.json'), 'utf8')).version; + for (const name of ['@traceai/auto', 'openai', '@opentelemetry/instrumentation-http']) packages[name] = JSON.parse(await readFile(join(app, 'node_modules', name, 'package.json'), 'utf8')).version; const receipt = { node: process.version, packages, executedBlocks: done.size, totalBlocks: blocks.length, results, scope: 'Synthetic loopback provider and OTLP only; not a live Cloud test.' }; await writeFile(join(output, 'snippets.json'), JSON.stringify(receipt, null, 2)); await writeFile(join(output, 'otlp.json'), JSON.stringify(batches, null, 2)); diff --git a/scripts/auto.browser.mjs b/scripts/auto.browser.mjs index e34ce82ae..8b721cf75 100644 --- a/scripts/auto.browser.mjs +++ b/scripts/auto.browser.mjs @@ -1,6 +1,7 @@ import assert from 'node:assert/strict'; import { mkdir, writeFile } from 'node:fs/promises'; import { chromium } from 'playwright'; +import { createDocsContext } from './docs-browser.cjs'; const base = 'http://127.0.0.1:4321'; const route = '/docs/integrations/traceai/auto'; @@ -9,7 +10,7 @@ await mkdir(out, { recursive: true }); const browser = await chromium.launch({ headless: true }); const results = []; try { - const context = await browser.newContext({ viewport: { width: 1440, height: 1000 }, permissions: ['clipboard-read', 'clipboard-write'] }); + const context = await createDocsContext(browser, base,{ viewport: { width: 1440, height: 1000 }, permissions: ['clipboard-read', 'clipboard-write'] }); const page = await context.newPage(); const errors = []; page.on('pageerror', error => errors.push(error.message)); diff --git a/scripts/browser-network.browser.cjs b/scripts/browser-network.browser.cjs new file mode 100644 index 000000000..6cc7055ea --- /dev/null +++ b/scripts/browser-network.browser.cjs @@ -0,0 +1,48 @@ +const assert = require('node:assert/strict'); +const { createServer } = require('node:http'); +const { chromium } = require('playwright'); +const { createDocsContext } = require('./docs-browser.cjs'); + +(async () => { + // Two loopback origins stand in for the docs and a stalled analytics server. + // No external service is contacted, even for the original-failure proof. + let analyticsRequests = 0; + const analytics = createServer(() => { analyticsRequests++; }); + await new Promise(resolve => analytics.listen(0, '127.0.0.1', resolve)); + const analyticsUrl = `http://127.0.0.1:${analytics.address().port}/analytics.js`; + const docs = createServer((request, response) => { + if (request.url === '/ready.js') { + response.writeHead(200, { 'content-type': 'text/javascript' }); + response.end('document.body.dataset.ready = "true";'); + } else { + response.writeHead(200, { 'content-type': 'text/html' }); + response.end(`

Docs fixture

`); + } + }); + await new Promise(resolve => docs.listen(0, '127.0.0.1', resolve)); + const base = `http://127.0.0.1:${docs.address().port}`; + let browser; + try { + browser = await chromium.launch({ headless: true }); + const original = await browser.newContext(); + const page = await original.newPage(); + await page.goto(base, { waitUntil: 'domcontentloaded' }); + await page.locator('body[data-ready="true"]').waitFor(); + await assert.rejects(page.waitForLoadState('networkidle', { timeout: 1500 }), /Timeout/); + assert.equal(analyticsRequests, 1, 'The stalled third party, not docs readiness, blocks networkidle'); + await original.close(); + + const context = await createDocsContext(browser, base); + const isolated = await context.newPage(); + assert.equal((await isolated.goto(base, { waitUntil: 'networkidle', timeout: 5000 })).status(), 200); + assert.equal(await isolated.locator('body').getAttribute('data-ready'), 'true', 'First-party script still executes'); + assert.equal(analyticsRequests, 1, 'Isolated docs checks never contact the second origin'); + await context.close(); + console.log('PASS stalled third-party reproduction; isolation retains real first-party loading'); + } finally { + await browser?.close(); + docs.closeAllConnections(); + analytics.closeAllConnections(); + await Promise.all([new Promise(resolve => docs.close(resolve)), new Promise(resolve => analytics.close(resolve))]); + } +})().catch(error => { console.error(error); process.exitCode = 1; }); diff --git a/scripts/docs-browser.cjs b/scripts/docs-browser.cjs new file mode 100644 index 000000000..b7fa7bcd5 --- /dev/null +++ b/scripts/docs-browser.cjs @@ -0,0 +1,17 @@ +// Docs UI checks exercise the built site, not analytics, font CDNs or GitHub's +// star API. Keep first-party requests real, including navigation and Pagefind. +/** + * @param {import('playwright').Browser} browser + * @param {string} base + * @param {import('playwright').BrowserContextOptions} [options] + * @returns {Promise} + */ +async function createDocsContext(browser, base, options = {}) { + const context = await browser.newContext(options); + const origin = new URL(base).origin; + await context.route('**/*', route => + new URL(route.request().url()).origin === origin ? route.continue() : route.abort()); + return context; +} + +module.exports = { createDocsContext }; diff --git a/scripts/integrations.browser.cjs b/scripts/integrations.browser.cjs index 6e18e2fd9..62dec6004 100644 --- a/scripts/integrations.browser.cjs +++ b/scripts/integrations.browser.cjs @@ -1,4 +1,5 @@ const {chromium} = require('playwright'); +const {createDocsContext} = require('./docs-browser.cjs'); const fs=require('node:fs/promises'); const assert=require('node:assert/strict'); const path=require('node:path'); @@ -20,7 +21,7 @@ async function record(name, fn) { try {const detail=await fn();results.push({nam const browser=await chromium.launch({headless:true}); for(const [name,width,height] of [['desktop',1440,1000],['tablet',768,1024],['mobile390',390,844],['mobile375',375,812]]) { await record(name+' responsive directory',async()=>{ - const ctx=await browser.newContext({viewport:{width,height},colorScheme:'dark'});const page=await ctx.newPage(); + const ctx=await createDocsContext(browser,BASE,{viewport:{width,height},colorScheme:'dark'});const page=await ctx.newPage(); await page.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'});await page.locator('[data-integration-directory][data-ready]').waitFor();await page.screenshot({path:OUT+'/after-'+name+'.png'}); assert.equal(await page.locator('[data-integration-card]:visible').count(),integrations.length); @@ -29,7 +30,7 @@ async function record(name, fn) { try {const detail=await fn();results.push({nam await ctx.close();return {width,height,firstCard:first}; }); } - const ctx=await browser.newContext({viewport:{width:1440,height:1000}});const page=await ctx.newPage();const errors=[];page.on('pageerror',e=>errors.push(String(e))); + const ctx=await createDocsContext(browser,BASE,{viewport:{width:1440,height:1000}});const page=await ctx.newPage();const errors=[];page.on('pageerror',e=>errors.push(String(e))); await page.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'}); const search=()=>page.locator('#integration-search'); async function query(q,n=1) {await search().fill(q);await page.waitForTimeout(450);assert.equal(await page.locator('[data-integration-card]:visible').count(),n,'query: '+q);} @@ -92,11 +93,11 @@ async function record(name, fn) { try {const detail=await fn();results.push({nam await page.goto(BASE+'/docs/integrations/google-adk',{waitUntil:'networkidle'});assert.equal(await page.locator('.integration-sidebar a[aria-current="page"]').innerText(),'Google ADK'); }); await record('reduced motion and light preference retain site dark tokens',async()=>{ - const c=await browser.newContext({viewport:{width:1440,height:1000},reducedMotion:'reduce',colorScheme:'light'});const p=await c.newPage();await p.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'}); + const c=await createDocsContext(browser,BASE,{viewport:{width:1440,height:1000},reducedMotion:'reduce',colorScheme:'light'});const p=await c.newPage();await p.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'}); assert.equal(await p.locator('[data-integration-card]').first().evaluate(e=>getComputedStyle(e).transitionDuration),'0s');const background=await p.locator('body').evaluate(e=>getComputedStyle(e).backgroundColor);await p.screenshot({path:OUT+'/after-light-reduced-motion.png'});await c.close();return {background}; }); await record('JavaScript disabled: all cards, category anchors and direct navigation',async()=>{ - const c=await browser.newContext({viewport:{width:375,height:812},javaScriptEnabled:false});const p=await c.newPage();await p.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'});assert.equal(await p.locator('[data-integration-card]:visible').count(),integrations.length);assert.equal(await p.locator('.directory-controls').isVisible(),false);await p.screenshot({path:OUT+'/no-js-mobile.png'}); + const c=await createDocsContext(browser,BASE,{viewport:{width:375,height:812},javaScriptEnabled:false});const p=await c.newPage();await p.goto(BASE+'/docs/integrations',{waitUntil:'networkidle'});assert.equal(await p.locator('[data-integration-card]:visible').count(),integrations.length);assert.equal(await p.locator('.directory-controls').isVisible(),false);await p.screenshot({path:OUT+'/no-js-mobile.png'}); await p.locator('noscript a[href="#java"]').click();await p.locator('[href="/docs/integrations/traceai/java/google-adk"][data-integration-card]').click();await p.waitForURL('**/java/google-adk');assert.equal(await p.locator('h1').count(),1);await c.close(); }); await record('no application JavaScript errors',async()=>{assert.deepEqual(errors,[]);}); diff --git a/scripts/integrations.regression.cjs b/scripts/integrations.regression.cjs index 8ffebd31a..f01289a84 100644 --- a/scripts/integrations.regression.cjs +++ b/scripts/integrations.regression.cjs @@ -1,6 +1,7 @@ // Regressions adapted from verify-scripts/{acceptance,matrix,race-proof}.cjs. // Run against the actual built docs shell, never a standalone logo atlas. const { chromium } = require('playwright'); +const { createDocsContext } = require('./docs-browser.cjs'); const fs = require('node:fs/promises'); const path = require('node:path'); const os = require('node:os'); @@ -55,7 +56,7 @@ function luminance(rgb) { return rgb.map(v => v / 255).map(v => v <= 0.04045 ? v const manifest = JSON.parse(await fs.readFile(path.join(__dirname, '../public/images/integrations/manifest.json'))); const browser = await chromium.launch({ headless: true }); for (const width of [1440, 768, 390, 375]) { - const context = await browser.newContext({ viewport: { width, height: 1000 }, colorScheme: 'dark', reducedMotion: 'reduce' }); + const context = await createDocsContext(browser, BASE,{ viewport: { width, height: 1000 }, colorScheme: 'dark', reducedMotion: 'reduce' }); const page = await context.newPage(); await record(`F1 logo navigation unobscured and scrollable ${width}`, async () => { await page.goto(BASE + '/docs/integrations', { waitUntil: 'networkidle' }); @@ -89,7 +90,7 @@ function luminance(rgb) { return rgb.map(v => v / 255).map(v => v <= 0.04045 ? v await record(`F4 slow uncached navigation cannot inherit pending query ${width}`, async () => { // New context ensures no FastNav/prefetch cache. Hold the network response // for 1s exactly as the independent real-fill/real-click reproduction did. - const c = await browser.newContext({ viewport: { width, height: 1000 } }); + const c = await createDocsContext(browser, BASE,{ viewport: { width, height: 1000 } }); try { const p = await c.newPage(), href = '/docs/integrations/traceai/anthropic'; await p.route('**' + href, async r => { await new Promise(resolve => setTimeout(resolve, 1000)); await r.continue(); }); @@ -113,7 +114,7 @@ function luminance(rgb) { return rgb.map(v => v / 255).map(v => v <= 0.04045 ? v } finally { await c.close(); } }); for (const javaScriptEnabled of [true, false]) await record(`F5 legacy fragments ${width} JS=${javaScriptEnabled}`, async () => { - const c = await browser.newContext({ viewport: { width, height: 1000 }, javaScriptEnabled }); + const c = await createDocsContext(browser, BASE,{ viewport: { width, height: 1000 }, javaScriptEnabled }); try { const p = await c.newPage(), rows = []; for (const [fragment, target] of Object.entries({ traceai: 'directory-setup', 'llm-models': 'providers', 'orchestration-frameworks': 'frameworks', other: 'apps', 'import-traces': 'import', 'export--alerts': 'export' })) { @@ -145,7 +146,7 @@ function luminance(rgb) { return rgb.map(v => v / 255).map(v => v <= 0.04045 ? v }); if (width < 1024) for (const cached of [false, true]) for (const href of ['/docs/integrations/traceai/bedrock', '/docs', '/docs/cookbook', '/docs/sdk', '/docs/api']) { await record(`F2 mobile dismissal ${width} ${cached ? 'cached' : 'uncached'} ${href}`, async () => { - const c = await browser.newContext({ viewport: { width, height: 1000 }, reducedMotion: 'reduce' }); + const c = await createDocsContext(browser, BASE,{ viewport: { width, height: 1000 }, reducedMotion: 'reduce' }); try { const p = await c.newPage(); let permit = false, actualRequests = 0; await p.route('**' + href, async route => { @@ -196,7 +197,7 @@ function luminance(rgb) { return rgb.map(v => v / 255).map(v => v <= 0.04045 ? v const source = await fs.readFile(path.join(__dirname, '../public', asset.file), 'utf8'); if (source.includes('prefers-color-scheme')) rows.push({ key, tile: asset.tile }); } - const c = await browser.newContext({ colorScheme: 'dark' }); + const c = await createDocsContext(browser, BASE,{ colorScheme: 'dark' }); try { const p = await c.newPage(); await p.goto(BASE + '/docs/integrations', { waitUntil: 'networkidle' }); for (const row of rows) { diff --git a/src/pages/docs/integrations/traceai/auto.mdx b/src/pages/docs/integrations/traceai/auto.mdx index 37cd73eca..d4c206d58 100644 --- a/src/pages/docs/integrations/traceai/auto.mdx +++ b/src/pages/docs/integrations/traceai/auto.mdx @@ -109,7 +109,7 @@ This is ordinary application code—there are no tracing imports. OpenAI SDK ver - **More application context:** installed dedicated integrations can add agent, tool, retrieval or database spans within their supported APIs. - **OpenTelemetry compatibility:** keep an existing provider, or use an [application-owned exporter](https://github.com/future-agi/traceAI/blob/d85da9c62d93c2661189e440c13e28f53ff85ff1/typescript/packages/traceai_auto/docs/CONFIGURATION.md#bring-your-own-opentelemetry-destination). -This is AI instrumentation, not a general-purpose APM agent: arbitrary functions and non-AI HTTP calls are not automatically traced. The wire observer yields to covered model spans to avoid duplicate capture. +This is AI instrumentation, not a general-purpose APM agent: arbitrary functions and outgoing non-AI HTTP calls are not automatically traced. If the optional `@opentelemetry/instrumentation-http` package is installed, the preload can also add incoming HTTP server spans. Set `FI_DISABLED_INSTRUMENTATIONS=http` to disable that integration. The wire observer yields to covered model spans to avoid duplicate capture. ## Supported libraries