Tsaheylu Documentation

pip install tsaheylu

import tsaheylu

tsaheylu.init("your-operator-token-32-chars-min")
tsaheylu.sync("my-agent", {"memory": ["task1", "task2"], "step": 42})

# Later, when restarting:
state = tsaheylu.restore("my-agent")
print(state)  # {"memory": ["task1", "task2"], "step": 42}

from tsaheylu import Client

client = Client(api_key="your-operator-token-32-chars-min")

# Sync state
client.sync("research-bot", {"papers": ["arxiv: 2401.1234"], "progress": 0.7})

# Recover state
state = client.restore("research-bot")

from tsaheylu.exceptions import HandleTakenError, HashMismatchError

try:
    tsaheylu.sync("my-agent", state)
except HandleTakenError:
    print("Handle already registered by another operator")
except HashMismatchError:
    print("Integrity check failed — retry")

curl -X POST https://api.tsaheylu.club/agent/signup \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "my-agent",
    "operator_handle": "your-name"
  }'

{
  "agent_id": "a1b2c3d4-e5f6-...",
  "handle": "my-agent",
  "operator_token": "abc123..."   // Save this! Shown only once.
}

# Set your real values:
TOKEN="your-operator-token-from-registration"
AGENT_ID="your-agent-id-from-registration"

# Capture state and compute hash:
STATE='{ "memory": ["task1", "task2"], "step": 42 }'
HASH=$(echo -n "$STATE" | sha256sum | awk '{print $1}')

# Send snapshot:
curl -X POST https://api.tsaheylu.club/agent/snapshot \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\":\"$AGENT_ID\",\"state_blob\":\"$STATE\",\"hash\":\"$HASH\"}"

curl -s https://api.tsaheylu.club/agent/recover/$AGENT_ID \
  -H "Authorization: Bearer $TOKEN"

{
  "snapshot_id": "uuid",
  "state_blob": "{ \"memory\": [\"task1\", \"task2\"], \"step\": 42 }",
  "verification_status": "verified",
  "version": 1,
  "recovery_event_id": "uuid"
}

import hashlib, json, requests

API = "https://api.tsaheylu.club"
TOKEN = "your-operator-token-from-registration"  # from /agent/signup

# 1. Register (or use the dashboard at tsaheylu.club/register)
agent = requests.post(f"{API}/agent/signup", json={
    "handle": "research-bot",
    "operator_handle": "your-name"
}).json()

agent_id = agent["agent_id"]
TOKEN = agent["operator_token"]  # Save this!
print(f"Registered: {agent_id}")

# 2. Snapshot
state = json.dumps({"memory": ["paper-1", "paper-2"], "step": 42})
state_hash = hashlib.sha256(state.encode()).hexdigest()

snap = requests.post(f"{API}/agent/snapshot",
    headers={"Authorization": f"Bearer {TOKEN}"},
    json={
        "agent_id": agent_id,
        "state_blob": state,
        "hash": state_hash
    }
).json()

print(f"Snapshot v{snap['version']}: {snap['snapshot_id']}")

# 3. Recover
recovered = requests.get(f"{API}/agent/recover/{agent_id}",
    headers={"Authorization": f"Bearer {TOKEN}"}
).json()

print(f"Status: {recovered['verification_status']}")
print(f"State: {recovered['state_blob']}")

import crypto from 'crypto';

const API = 'https://api.tsaheylu.club';
const TOKEN = 'your-operator-token-from-registration';  // from /agent/signup
const AGENT_ID = 'your-agent-id-from-registration';

async function snapshot(state) {
  const blob = JSON.stringify(state);
  const hash = crypto.createHash('sha256').update(blob).digest('hex');

  const res = await fetch(`${API}/agent/snapshot`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${TOKEN}`
    },
    body: JSON.stringify({ agent_id: AGENT_ID, state_blob: blob, hash })
  });

  return res.json();
}

// Auto-snapshot every 5 minutes
setInterval(() => {
  const currentState = getAgentState(); // your function
  snapshot(currentState).then(r => console.log('Snapshot:', r.version));
}, 5 * 60 * 1000);