Java SDK

Java integration for the Zeq OS REST API. Use HulyaSync for local temporal synchronization; call the API for operator computation.

Installation

<!-- pom.xml -->
<dependency>
    <groupId>com.zeqos</groupId>
    <artifactId>zeq-os-sdk</artifactId>
    <version>1.287.5</version>
</dependency>

Or integrate directly with Java's built-in HTTP client (Java 11+) — no extra dependency needed.

Authentication

import java.net.http.*;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

HttpClient client = HttpClient.newHttpClient();
ObjectMapper mapper = new ObjectMapper();
String BASE = "http://localhost";

// Register (first time)
String regBody = mapper.writeValueAsString(Map.of(
    "displayName", "Alice",
    "equation",    "x^2 + sin(y*pi) + phi"
));
HttpRequest regReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/users/register"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(regBody))
    .build();
HttpResponse<String> regResp = client.send(regReq, HttpResponse.BodyHandlers.ofString());
Map<?, ?> regData = mapper.readValue(regResp.body(), Map.class);
String token = (String) regData.get("token");

// Login
String loginBody = mapper.writeValueAsString(Map.of("equation", "x^2 + sin(y*pi) + phi"));
HttpRequest loginReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/users/login"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(loginBody))
    .build();
HttpResponse<String> loginResp = client.send(loginReq, HttpResponse.BodyHandlers.ofString());
Map<?, ?> loginData = mapper.readValue(loginResp.body(), Map.class);
String jwt = (String) loginData.get("token");

Quick Start

// 1. Browse operators — public, no auth needed
HttpRequest opReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/zeq/operators"))
    .GET().build();
HttpResponse<String> opResp = client.send(opReq, HttpResponse.BodyHandlers.ofString());
Map<?, ?> opData = mapper.readValue(opResp.body(), Map.class);
System.out.println("Operators loaded: " + ((Map<?, ?>) opData).get("count"));

// 2. Get HulyaPulse phase — no auth
HttpRequest phaseReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/zeq/phase"))
    .GET().build();
HttpResponse<String> phaseResp = client.send(phaseReq, HttpResponse.BodyHandlers.ofString());
System.out.println("Phase: " + phaseResp.body());

// 3. Execute operator — requires account
String execBody = mapper.writeValueAsString(Map.of(
    "params", Map.of("G", 6.674e-11, "m1", 5.97e24, "m2", 7.35e22, "r", 3.84e8)
));
HttpRequest execReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/zeq/operators/execute?operator=NM21"))
    .header("Authorization", "Bearer " + jwt)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(execBody))
    .build();
HttpResponse<String> execResp = client.send(execReq, HttpResponse.BodyHandlers.ofString());
System.out.println("Result: " + execResp.body());

// 4. 7-Step Wizard — requires account
String wizBody = mapper.writeValueAsString(Map.of(
    "query",     "gravitational time dilation near Earth",
    "operators", new String[]{"KO42", "GR37"},
    "mode",      "basic"
));
HttpRequest wizReq = HttpRequest.newBuilder()
    .uri(URI.create(BASE + "/api/7step/run"))
    .header("Authorization", "Bearer " + jwt)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(wizBody))
    .build();
HttpResponse<String> wizResp = client.send(wizReq, HttpResponse.BodyHandlers.ofString());
Map<?, ?> state = mapper.readValue(wizResp.body(), Map.class);
System.out.println("Operators: " + state.get("selected_operators"));
System.out.println("Master sum: " + state.get("master_sum"));

HulyaSync (Local)

import com.zeqos.sdk.HulyaSync;

HulyaSync sync = new HulyaSync();

// All methods run locally — no server, no auth
System.out.printf("Phase:   %.4f%n", sync.currentPhase());
System.out.printf("Zeqond:  %d%n",   sync.getZeqond());
System.out.printf("KO42:    %.6f%n", sync.ko42Automatic());

// Zeq Equation: R(t) = S(t) × [1 + α·sin(2πft)]
double modulated = sync.modulate(9.80665);
System.out.printf("g mod:   %.6f%n", modulated);
System.out.println(sync.daemonTick());

Framework Equations

Zeq Equation:   R(t) = S(t) × [1 + α × sin(2π × 1.287 × t)]
KO42:           α × sin(2π × 1.287 × t)
HULYAS:         □(φ) − μ²(r)φ − λφ³ − exp(−φ/φ_c) + φ₄₂ × Σ(Cₖ(φ)) = T^μ_μ + βF·F + J_ext

REST API Reference

Endpoint	Auth	Description
POST /api/users/login	—	Login with equation
GET /api/zeq/phase	—	HulyaPulse phase + KO42
GET /api/zeq/operators	—	All operators + equations (public)
POST /api/zeq/operators/execute?operator=ID	Required	Execute operator
POST /api/7step/run	Required	7-Step Wizard
POST /api/7step/parse	Required	Parse query → operators

Architecture

sdk/java/
├── pom.xml
└── src/main/java/com/zeqos/sdk/
    ├── HulyaSync.java          # Local 1.287 Hz engine
    ├── ZeqClient.java          # REST API client
    └── ZeqState.java           # Computation result record