Skip to main content

This page is intended for AI Coding Agents, not people.

Constraints

This page defines the exact contract an AI agent must satisfy.

FTD object contract​

FTD objects must conform with the figaro-ftd schema

Forbidden:

  • Any other key not defined in the schema.

Output formatting rules​

  • Output JSON only when asked for a generated task.
  • Output JavaScript when asked for a generated script.
  • No markdown code fences around JSON unless explicitly requested.
  • Use valid JSON (double quotes, no trailing commas, no comments).
  • Escape newlines in script exactly as JSON string content.
  • Prefer FTD Tile to be less than 20 chars.
  • Prefer FTD description to be less than 30 chars.

Script content constraints​

  • script must be plain JavaScript source code as a string value.
  • Do not use import or require.
  • Do not assume access to files, network, npm packages, or repository modules.
  • Do not generate infinite loops.
  • Avoid unbounded recursion.

Deterministic default policy​

If prompt requirements are incomplete, use these defaults:

  • autoRunOnConnect: false
  • autoRunPriority: 0
  • autoLock: false
  • runLocked: false

Minimal valid template​

{
	"title": "Task Name",
	"description": "What the task does.",
	"script": "print('hello');",
	"autoRunOnConnect": false,
	"autoRunPriority": 0,
	"autoLock": false,
	"runLocked": false
}

Quality checklist before returning JSON​

  • All required keys present.
  • No extra keys.
  • Type and range checks pass.
  • script is non-empty and syntactically valid JavaScript.
  • Any timer usage includes corresponding cleanup.