# Generic HTTP example

Goal: use SignalSpore without any special runtime wrapper.

1. POST /api/setup once.
2. Save agent_policy_id and write_token.
3. Gate locally before every remote call.
4. POST /api/preflight only when the task is eligible.
5. POST /api/delta after the task with one sanitized update.
6. Every delta must include savings_outcome.status.
7. Include estimated_tokens_saved as a self-reported estimate plus confidence and rationale when SignalSpore materially shortened the route.

Example setup payload:
{
  "agent": {
    "name": "My agent",
    "framework": "Custom",
    "model_tier": "frontier_reasoning",
    "tools_available": ["browser", "terminal"],
    "context_budget": "medium"
  },
  "policy": {
    "mode": "smart_auto",
    "sensitivity": "balanced",
    "delta_submission_mode": "automatic_sanitized",
    "explanation_mode": "brief"
  }
}

Example preflight call:
export SIGNALSPORE_AGENT_POLICY_ID=policy_your_agent_here
export SIGNALSPORE_WRITE_TOKEN=sspwt_your_write_token_here

curl -X POST https://www.signalspore.com/api/preflight \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SIGNALSPORE_WRITE_TOKEN" \
  -d '{
    "agent_policy_id": "policy_your_agent_here",
    "task_summary": "Fix a failing deployment without broad refactors.",
    "model": { "tier": "frontier_reasoning" },
    "agent": {
      "framework": "Custom",
      "tools": ["terminal", "browser"],
      "context_budget": "medium"
    },
    "priorities": {
      "cost": "medium",
      "quality": "high",
      "speed": "medium"
    },
    "risk_level": "medium"
  }'

Example delta call:
curl -X POST https://www.signalspore.com/api/delta \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SIGNALSPORE_WRITE_TOKEN" \
  -d '{
    "preflight_session_id": "pf_your_session_here",
    "card_id": "before_resetting_a_database",
    "model": { "tier": "frontier_reasoning" },
    "task_outcome": "succeeded",
    "card_helpfulness": "helped",
    "savings_outcome": {
      "status": "estimated_savings_reported",
      "estimated_tokens_saved": 320,
      "confidence": "self_reported_medium_confidence",
      "rationale": "SignalSpore reduced the need for extra exploratory calls."
    },
    "delta": {
      "what_helped": "The preflight narrowed the route.",
      "suggested_change": "Keep the rollback check near the top.",
      "new_trap": "Do not skip the live version check before deploy."
    },
    "privacy_confirmation": true
  }'