| --- |
| title: Substrate Mesh Runtime Connector API |
| emoji: 🧬 |
| colorFrom: blue |
| colorTo: indigo |
| sdk: docker |
| app_file: app.py |
| app_port: 7860 |
| pinned: false |
| license: cc-by-nc-sa-4.0 |
| short_description: Private Substrate connector API for GPT Actions |
| --- |
| |
| # Substrate Mesh Runtime — Primordial OS Runtime Connector API Wrapper v3.3.1 |
|
|
| Created and developed by Collin D. Weber. |
| Systems Architect / Systems Integrity Steward: Collin D. Weber. |
|
|
| ## Purpose |
|
|
| This packet turns the v3.3 Primordial OS Runtime Connector contract into a deployable HTTPS API wrapper for GPT Actions. |
|
|
| It is intended to be deployed as a private Hugging Face Docker Space first, then connected to the existing Primordial OS Runtime GPT through the GPT Builder Action panel. |
|
|
| ## Boundary |
|
|
| - canonical source artifacts remain read-only; |
| - canonical Primordial Lexicon remains read-only; |
| - user/GPT outputs are workspace-local overlay proposals only; |
| - no final validation claims; |
| - no publication authority; |
| - no clinical/legal/deployment authority; |
| - human review remains required; |
| - HIR × OAM pressure receipt is preserved. |
|
|
| ## API routes |
|
|
| ```text |
| GET /v1/mesh/health |
| POST /v1/mesh/command |
| GET /v1/mesh/receipt/{command_id}?workspace_id=... |
| ``` |
|
|
| `/v1/mesh/command` and `/v1/mesh/receipt/{command_id}` require: |
|
|
| ```text |
| Authorization: Bearer <SUBSTRATE_ACTION_KEY> |
| ``` |
|
|
| ## Local test |
|
|
| ```bash |
| export SUBSTRATE_ACTION_KEY="test-secret-key" |
| python validate_substrate_connector_api_v3_3_1.py |
| ``` |
|
|
| ## Local server |
|
|
| ```bash |
| export SUBSTRATE_ACTION_KEY="replace-with-a-long-random-secret" |
| uvicorn app:app --host 0.0.0.0 --port 7860 |
| ``` |
|
|
| Health check: |
|
|
| ```bash |
| curl http://localhost:7860/v1/mesh/health |
| ``` |
|
|
| Command test: |
|
|
| ```bash |
| curl -X POST http://localhost:7860/v1/mesh/command -H "Authorization: Bearer $SUBSTRATE_ACTION_KEY" -H "Content-Type: application/json" -d @examples/requests/robotics_humans_dna_request.json |
| ``` |
|
|
| ## GPT Action schema |
|
|
| Use: |
|
|
| ```text |
| openapi/openapi.yaml |
| ``` |
|
|
| Before pasting into GPT Actions, replace: |
|
|
| ```text |
| https://YOUR-HF-SPACE.hf.space |
| ``` |
|
|
| with your deployed Hugging Face Space URL. |
|
|
| ## Deployment posture |
|
|
| This packet is API-wrapper-ready. It does not deploy itself. The operator still creates the Hugging Face Docker Space, adds `SUBSTRATE_ACTION_KEY` as a Space secret, uploads these files, and then connects the schema to the Primordial OS Runtime GPT Action panel. |
|
|
