Extending the Runtime

User request -> Base Runtime (:3100)
  -> Forward to PROVIDER_URL (TrustGate, Ollama, vLLM, OpenAI)
  <- Response
  -> Create receipt via LUCID_API_URL (async, non-blocking)

lucid launch --runtime base \
  --model openai/gpt-4o \
  --prompt "You are a research assistant with web access" \
  --target docker \
  --env LUCID_TOOLS=web-search,github

lucid launch --runtime base \
  --model openai/gpt-4o \
  --prompt "You are a personal assistant that remembers context" \
  --target docker \
  --env MEMORY_ENABLED=true \
  --env MEMORY_STORE=sqlite \
  --env MEMORY_EXTRACTION_ENABLED=true

# Use TrustGate (managed)
PROVIDER_URL=https://trustgate.lucid.foundation

# Use local Ollama
PROVIDER_URL=http://localhost:11434/v1

# Use vLLM
PROVIDER_URL=http://vllm-server:8000/v1

# Use LiteLLM
PROVIDER_URL=http://litellm:4000/v1

DEPIN_UPLOAD_ENABLED=true
DEPIN_PERMANENT_PROVIDER=arweave    # For immutable data
DEPIN_EVOLVING_PROVIDER=lighthouse  # For mutable data

import express from "express";
import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai";

const app = express();
const lucid = new RaijinLabsLucidAi({
  serverURL: process.env.LUCID_API_URL || "https://api.lucid.foundation",
  security: { bearerAuth: process.env.LUCID_API_KEY },
});

// Add your custom logic
app.post('/run', async (req, res) => {
  // Custom preprocessing
  const enrichedPrompt = await myPreprocessor(req.body.prompt);

  // Inference with automatic receipt
  const result = await lucid.run.chatCompletions({
    body: {
      model: process.env.LUCID_MODEL || "openai/gpt-4o",
      messages: [{ role: "user", content: enrichedPrompt }],
    },
  });

  // Custom postprocessing
  const finalResult = await myPostprocessor(result);
  res.json(finalResult);
});

app.listen(3100);

lucid launch --image my-custom-runtime:latest --target railway

# Deploy new version alongside existing
curl -X POST https://api.lucid.foundation/v1/agents/:passportId/deploy/blue-green \
  -H "Authorization: Bearer lk_..." \
  -d '{"image": "my-runtime:v2.0.0"}'

# Promote after health check passes
curl -X POST https://api.lucid.foundation/v1/agents/:passportId/promote \
  -H "Authorization: Bearer lk_..."

# Or rollback if issues are detected
curl -X POST https://api.lucid.foundation/v1/agents/:passportId/rollback \
  -H "Authorization: Bearer lk_..."