Neural OS Documentation

// Store your key in an environment variable — never hardcode it.
// .env.local
EVOROZEN_API_KEY=evo_live_your_key_here

// lib/neural.ts  — reusable fetch helper
const API_ENDPOINT = 'https://pulse.evorozen.com/api/neural';

async function neuralRequest(body: Record<string, unknown>) {
  const res = await fetch(API_ENDPOINT, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.EVOROZEN_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error(`Neural API error: ${res.status}`);
  return res.json();
}

// Step 1 — Define the table schema (registers into LivingDNA Rulebook)
await neuralRequest({
  action_type: 'create_schema',
  prompt: 'Define users table',
  data_payload: {
    tables: [{
      name: 'users',
      columns: [
        { name: 'id',    type: 'uuid', primary: true },
        { name: 'name',  type: 'text' },
        { name: 'email', type: 'text' },
      ],
    }],
  },
});

// Step 2 — Insert a record into the table
const res = await neuralRequest({
  action_type: 'insert_data',
  prompt: 'Insert new user',
  data_payload: {
    table: 'users',
    record: { name: 'Ada Lovelace', email: 'ada@example.com' },
  },
});

console.log(res);
// { action: 'insert_data', table: 'users', row: { _id: '...', name: 'Ada Lovelace', ... } }

// Chat with the Neural AI Engine — natural language to database
const res = await neuralRequest({
  action_type: 'chat',
  prompt: 'Create a products table with name, price, and stock columns',
});

console.log(res.response);  // AI narrative + detected schema
console.log(res.traceId);   // Kernel trace ID for debugging

// The AI may also auto-execute schema creation via the Agentic Executor.
// Check res.schema_execution for deterministic execution results:
if (res.schema_execution?.executed) {
  console.log('Tables created:', res.schema_execution.tablesCreated);
}