Close Enterprise AI Deals Faster with Audit-Ready Scope 3 Carbon & AI-BOM Reporting
Enterprise procurement officers, security teams, and ESG auditors increasingly ask for Scope 3 AI energy & carbon disclosures, CycloneDX / SPDX AI Bills of Materials (AI-BOM), and EU AI Act & US NIST AI RMF compliance attestations before approving AI vendors. @shdwsdk/sdk automates the data collection in minutes, off your request path so your application's response time is unaffected.
Everything @shdwsdk/sdk Does Out of the Box
One lightweight SDK package replaces weeks of manual engineering spreadsheets, ESG audits, and security questionnaire back-and-forth.
1. Automated Multi-Provider Token & SSE Stream Normalization
Automatically parses input and output token counts across OpenAI (GPT and o-series), Anthropic (Claude), Google (Gemini), and real-time Server-Sent Events (SSE) streaming responses.
2. Scientific Energy (kWh) & Scope 3 Carbon (gCO₂e) Engine
Converts generated tokens into electricity (kWh) and Scope 3 emissions (gCO₂e) with the open-source EcoLogits methodology, data center PUE, and regional grid factors (EEA / Ember for Europe, EPA eGRID for the US), reported as ranges.
3. Strictly Non-Blocking, Fail-Silent Queue & 5xx Retry
Dispatches telemetry asynchronously in the background with a hard 1500ms AbortController timeout and automatic 5xx retry buffering. Even if telemetry servers go offline, your app never slows down or throws errors.
4. Cryptographic AI Bill of Materials (AI-BOM) Lineage
Tracks model versions, RAG vector databases (Pinecone, pgvector, Weaviate), embedding models, system prompt versions (prompt_hash_version) and, for models you host, SHA-256 weight digests (weights_hash).
5. CycloneDX v1.7 & SPDX 3.0 Standard Exports
Compiles your active AI supply chain into industry-standard CycloneDX ML-BOM v1.7 (`.cdx.json`) and SPDX 3.0 AI Profile JSON-LD (`.spdx.json`) files ready for enterprise security and procurement auditors.
6. EU AI Act & US NIST AI RMF 1.0 Governance Matrix
Classify workloads against EU AI Act risk tiers (Unacceptable/prohibited, High, Limited, Minimal) and map internal controls across all four NIST AI RMF functions (Govern, Map, Measure, Manage) on a shareable Public Trust Center (shdwsdk.ai/trust/[slug]).
Answer What Enterprise Buyers Actually Ask For
Large customers now ask suppliers for the AI emissions of the services they buy, and security reviews ask the same AI questions every time. SHDWsdk answers both from your production data.
Per-customer emissions statements
Tag AI calls with the customer they serve and issue each customer a statement of the AI emissions allocated to them, with ranges, methodology and an audit-chain reference, ready for their Scope 3 Category 1 reporting.
Security questionnaire answers
Draft answers to 21 common AI questions in security reviews and RFPs, written from your inventory, telemetry and audit log. Policy questions are left for you to fill in; nothing is claimed that your data doesn't show.
Buyer requests in one place
Buyers request your AI documentation from your trust page and see your response there. Buying from a vendor that isn't on SHDWsdk? Ask them for their AI documentation for free.
Fits your stack
JavaScript and Python SDKs, a LiteLLM callback, or plain OpenTelemetry GenAI spans with no code changes. Slack and webhook alerts, provider-billing coverage checks, and a monthly CSV for carbon accounting tools.
Wrap Your Existing AI Client in 3 Lines of Code
No proxy routing, no prompt logging, and zero changes to how your application calls OpenAI, Anthropic, or Google Gemini. @shdwsdk/sdk observes only token metadata and model identifiers—your customer prompts and completions never leave your servers.
- ✓ Zero Prompt / PII Exposure — Only token counts & model IDs are transmitted
- ✓ Cross-Platform — Microsoft Windows, Apple macOS, Linux, Docker, and Kubernetes
- ✓ Works Everywhere — Next.js, Node.js, Express, Fastify, Python (OpenAI, Anthropic, LiteLLM), and any OpenTelemetry GenAI instrumentation
import OpenAI from "openai";
import { ShdwTelemetryClient, compileCycloneDxMlBom } from "@shdwsdk/sdk";
// 1. Initialize non-blocking telemetry client (1.5s timeout guard)
const shdw = new ShdwTelemetryClient({
apiKey: process.env.SHDW_API_KEY!,
endpoint: "https://www.shdwsdk.ai/api/v1/ingest-telemetry",
defaultGridRegion: "us-west-2",
});
// 2. Wrap your OpenAI, Anthropic, or Gemini client in one line
export const openai = shdw.wrapClient(new OpenAI(), {
provider: "openai",
gridRegion: "us-west-2",
});Frequently Asked Questions (Enterprise Procurement, Security & Engineering)
Clear answers for CTOs, VPs of Sales, and enterprise compliance reviewers.
Does @shdwsdk/sdk add latency or risk crashing our production AI features?
No. Telemetry is sent in the background, after your response is returned, with a strict 1500ms AbortController timeout and silent try/catch isolation. If our ingest endpoint is unreachable, events are buffered and retried, and any that can't be delivered are counted in getDeliveryStats() so gaps in coverage are visible.
Does SHDWsdk ever read or store our customer prompts or AI outputs?
No. @shdwsdk/sdk inspects only numeric token usage metadata (prompt_tokens, completion_tokens), model identifiers, and cryptographic SHA-256 digests. Prompt text and completions never leave your infrastructure.
Which AI Bill of Materials (AI-BOM) and regulatory standards are supported?
SHDWsdk natively compiles CycloneDX ML-BOM v1.7 (`.cdx.json`) and SPDX 3.0 AI Profile JSON-LD (`.spdx.json`) documents, alongside GHG Protocol Scope 3 reports, EU AI Act risk classifications, and US NIST AI RMF 1.0 control mappings.
What operating systems and programming frameworks can install @shdwsdk/sdk?
@shdwsdk/sdk runs on Microsoft Windows, Apple macOS, and Linux across Node.js 18+, Next.js, Express, Fastify, Bun, Deno and Docker. For Python, pip install shdwsdk instruments OpenAI and Anthropic clients and LiteLLM; any other language can send OpenTelemetry GenAI spans.
Plans for Every Stage of Enterprise Selling
Start with a 14-day free trial on any self-serve plan. Need a DPA, security review support or invoicing? Talk to us about Enterprise.
Starter
Billed monthly
For AI product teams answering their first enterprise security and sustainability questionnaires.
- Up to 100M AI tokens tracked per month
- Public Trust Report, badge & buyer requests
- Per-customer emissions statements & CSV exports
- Security questionnaire answers (CSV / Markdown)
- Slack & webhook alerts
- CycloneDX & SPDX AI-BOM exports
14-day free trial · cancel anytime
Scale
Billed monthly
For multi-region companies selling to large enterprises with strict sustainability and AI governance reviews.
- Everything in Starter
- Unlimited AI usage tracking
- Custom data center region selection
- EU AI Act & NIST AI RMF governance matrix
- Priority support
14-day free trial · cancel anytime
Enterprise
Annual agreement
For organizations with procurement, legal and security requirements beyond self-serve.
- Everything in Scale
- Security review & questionnaire support
- DPA, custom MSA and SLA
- Annual invoicing (no card required)
- Dedicated onboarding & support
Ready to Make Your AI Workloads Enterprise RFP-Ready?
Create your account, set up your company profile, and launch your Scope 3 AI Carbon & AI-BOM Compliance Console in under two minutes.
