jobs

naive jobs
naive jobs --status processing
naive jobs --status completed --limit 5

{
  "success": true,
  "action": "jobs.list",
  "result": {
    "jobs": [
      { "id": "job-uuid-1", "type": "video_generation", "status": "processing", "progress": 45, "model": "fal-ai/minimax-video/video-01-live", "created_at": "2025-01-15T10:30:00Z" },
      { "id": "job-uuid-2", "type": "image_generation", "status": "completed", "progress": 100, "model": "fal-ai/flux/schnell", "created_at": "2025-01-15T10:25:00Z" }
    ]
  },
  "next_steps": [
    { "command": "naive jobs get job-uuid-1", "description": "Check progress of video_generation job" },
    { "command": "naive jobs --status completed --limit 5", "description": "See recently completed jobs with results" },
    { "command": "naive jobs cancel job-uuid-1", "description": "Cancel a running job (no credits charged)" }
  ],
  "hints": [
    "2 jobs found",
    "1 active (queued/processing)",
    "Credits are deducted only when jobs complete successfully"
  ]
}

naive jobs get <job-id>

{
  "success": true,
  "action": "jobs.get",
  "result": {
    "id": "job-uuid-1",
    "type": "video_generation",
    "status": "processing",
    "progress": 65,
    "model": "fal-ai/minimax-video/video-01-live",
    "input": { "prompt": "a rocket launching" },
    "created_at": "2025-01-15T10:30:00Z",
    "started_at": "2025-01-15T10:30:02Z"
  },
  "next_steps": [
    { "command": "naive jobs get job-uuid-1", "description": "Check again in a few seconds" },
    { "command": "naive jobs cancel job-uuid-1", "description": "Cancel this job" }
  ],
  "hints": ["Job job-uuid-1: processing", "Job is actively processing — check back soon"]
}

{
  "success": true,
  "action": "jobs.get",
  "result": {
    "id": "job-uuid-1",
    "type": "video_generation",
    "status": "completed",
    "progress": 100,
    "model": "fal-ai/minimax-video/video-01-live",
    "result": {
      "video": { "url": "https://fal.media/files/.../video.mp4" }
    },
    "credits_used": "3.0000",
    "created_at": "2025-01-15T10:30:00Z",
    "started_at": "2025-01-15T10:30:02Z",
    "completed_at": "2025-01-15T10:31:15Z"
  },
  "next_steps": [
    { "command": "naive video generate \"new prompt\"", "description": "Generate another video" }
  ],
  "hints": ["Job completed — result is included above"]
}

naive jobs cancel <job-id>

{
  "success": true,
  "action": "jobs.cancel",
  "result": { "job_id": "job-uuid-1", "cancelled": true },
  "next_steps": [
    { "command": "naive jobs --status processing", "description": "Check remaining active jobs" },
    { "command": "naive jobs get job-uuid-1", "description": "Verify cancellation status" }
  ],
  "hints": [
    "Job cancellation requested — no credits will be charged",
    "Running jobs may still complete if processing already started"
  ]
}

naive status

{
  "success": true,
  "action": "status",
  "result": {
    "agent": { "id": "uuid", "name": "Research Bot" },
    "company": { "id": "uuid", "name": "Acme Corp" },
    "credits": { "balance": 87.5, "tier": "pro" },
    "resources": { "email_inboxes": 2, "active_jobs": 1 }
  },
  "next_steps": [
    { "command": "naive usage", "description": "See detailed credit usage history" },
    { "command": "naive jobs --status processing", "description": "Check active async jobs" }
  ],
  "hints": ["Balance: 87.5 credits (pro tier)"]
}

naive usage
naive usage --days 7
naive usage --days 1 --limit 100

{
  "success": true,
  "action": "usage",
  "result": {
    "transactions": [
      { "type": "deduction", "amount": "-1.00", "operation": "email_send", "reference_id": "msg-uuid", "created_at": "..." },
      { "type": "deduction", "amount": "-3.00", "operation": "job_completion", "reference_id": "job-uuid", "created_at": "..." }
    ]
  },
  "next_steps": [
    { "command": "naive status", "description": "See current balance summary" },
    { "command": "naive usage --days 1", "description": "Narrow to today's usage only" }
  ],
  "hints": [
    "Showing 2 transactions from the last 30 days",
    "Async jobs deduct credits only on completion"
  ]
}