File size: 2,375 Bytes
734b51a 25b7932 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | ---
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.
|