Research-Stack/4-Infrastructure/NoDupeLabs/connectors/wolfram/WOLFRAM_PRIVATE_SETUP.md
2026-05-11 22:25:43 -05:00

2.6 KiB

PRIVATE Wolfram Alpha Connector Surface

Bounded computational oracle for Research Stack.

Authority boundary

  • Wolfram Alpha = computational check / external calculation surface
  • Graph.lean = canonical proof / graph authority
  • ENE = provenance / archive authority
  • FAMM = route-memory outcome layer after authority gating

Wolfram can check, simplify, solve, numerically probe, and produce external calculation receipts. It cannot certify proof, empirical validity, or basin promotion.

Security rule

This connector must never be public.

Allowed exposure:

  • localhost
  • VPN
  • tailnet
  • SSH tunnel
  • private reverse proxy

Forbidden exposure:

  • public internet
  • public OpenAPI action
  • unauthenticated HTTP
  • public webhook

Environment

export WOLFRAM_CONNECTOR_TOKEN="YOUR_WOLFRAM_CONNECTOR_TOKEN"
export WOLFRAM_APP_ID="your-private-wolfram-alpha-app-id"
export WOLFRAM_MAX_QUERY_CHARS=1600
export WOLFRAM_TIMEOUT_MS=15000

Never store WOLFRAM_APP_ID or WOLFRAM_CONNECTOR_TOKEN in GitHub, Notion, Drive, Obsidian, or logs.

Mount

In server.js:

import wolframRouter from "./connectors/wolfram/wolfram_alpha_connector_router.js";
app.use("/wolfram", wolframRouter);

Endpoints

Mounted under /wolfram:

GET  /wolfram/health
POST /wolfram/short
POST /wolfram/query
POST /wolfram/validate-equation
POST /wolfram/numeric-probe

Smoke tests

curl -H "Authorization: Bearer $WOLFRAM_CONNECTOR_TOKEN" \
  http://127.0.0.1:3000/wolfram/health
curl -X POST http://127.0.0.1:3000/wolfram/short \
  -H "Authorization: Bearer $WOLFRAM_CONNECTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"integral of x^2 from 0 to 1"}'
curl -X POST http://127.0.0.1:3000/wolfram/validate-equation \
  -H "Authorization: Bearer $WOLFRAM_CONNECTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"equation":"m*a = -k*x", "variable":"a", "domain":"coupled oscillator"}'
curl -X POST http://127.0.0.1:3000/wolfram/numeric-probe \
  -H "Authorization: Bearer $WOLFRAM_CONNECTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expression":"0.5*6^2.4"}'

Research Stack path

equation / motif / numeric probe
→ Wolfram computational check
→ receipt hash
→ ENE provenance record
→ Graph.lean / independent derivation gate
→ torsion / FAMM outcome

Basin rule

Wolfram result → HOLD computational witness

Never:

Wolfram result → direct proof
Wolfram result → direct basin

A Wolfram hit can only reduce review cost or create a computational witness pending canonical audit.