Skip to main content

​
FYP Warmup

fyp_warmup is implemented, but it is not currently allowed for unattended use.

​
Current Restriction

The current code treats fyp_warmup as:
  • implemented
  • manual_only
  • not live verified for unattended execution
That means:
  • mode: "manual" is allowed
  • mode: "unattended" is rejected

​
What It Does

Phonefarm turns an fyp_warmup capability request into a fyp_warmup_session execution plan that scans the For You feed and applies OpenClaw-style judging policy using caller-provided prompts.

​
Minimal Valid Request

{
  "request_id": "fyp-2026-03-22-001",
  "capability": "fyp_warmup",
  "mode": "manual",
  "target": {
    "routing": "direct",
    "phone_id": "phone_01",
    "account_id": "account_user095916355"
  },
  "inputs": {
    "good_quota": 3,
    "bad_quota": 6,
    "max_scans": 18,
    "comment_probability": 0,
    "fyp_judge_prompt": {
      "prompt_id": "ugc.fyp.judge.relationship.v1",
      "name": "FYP Judge Relationship V1",
      "version": "1",
      "system_prompt": "You are judging TikTok FYP warmup fit.",
      "task_prompt": "Return yes only for target-fit content.",
      "output_contract": {
        "type": "json_object"
      }
    }
  },
  "callback": {
    "url": "https://ugc-tracker.example.com/phonefarm/process-updates",
    "metadata": {}
  },
  "requested_by": {
    "system": "ugc-tracker",
    "user": "operator@example.com",
    "metadata": {}
  }
}

​
Inputs

FieldTypeNotes
good_quotaintegerDefaults to 3.
bad_quotaintegerDefaults to 6.
max_scansintegerDefaults to 18. Must cover total quotas.
comment_poolstring[]Optional explicit comment pool.
fyp_profile_overrideobjectOptional local profile override.
fyp_judge_promptobjectRequired.
fyp_comment_pool_promptobjectRequired when comments are enabled and no explicit comment_pool is provided.
like_probabilitynumberOptional override.
save_probabilitynumberOptional override.
comment_probabilitynumberOptional override. Defaults to 0.08 when omitted.
dismiss_app_on_finishbooleanDefaults to true.
debug_tracebooleanDefaults to false.

​
Validation Rules

  • at least one of good_quota or bad_quota must be positive
  • max_scans must be greater than or equal to good_quota + bad_quota
  • fyp_judge_prompt is always required
  • when effective comment probability is greater than 0, either:
    • provide comment_pool, or
    • provide fyp_comment_pool_prompt

​
Comment Guidance

If you already have a controlled comment pool, send it directly. If Phonefarm needs to generate or refill comment text at runtime, send fyp_comment_pool_prompt.