VAP Execution Agent

{
  "protocolVersion": "0.3.0",
  "name": "VAP Execution Agent",
  "description": "Execution Control Layer for AI Agents. VAP is where nondeterminism stops. If your agents call paid APIs directly, you don't have cost control. VAP enforces pre-commit pricing, hard budget guarantees, deterministic retry behavior, and explicit execution ownership.",
  "version": "1.15.0",
  "supportedInterfaces": [
    {
      "url": "https://api.vapagent.com/a2a",
      "protocolBinding": "HTTP+JSON"
    }
  ],
  "provider": {
    "organization": "VAP",
    "url": "https://api.vapagent.com"
  },
  "documentationUrl": "https://api.vapagent.com/docs",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true,
    "stateTransitionHistory": true,
    "financialDeterminism": true,
    "providerAgnosticExecution": true,
    "pricing": {
      "currency": "USD",
      "model": "pre-commit",
      "presets": {
        "image.basic": 0.18,
        "video.basic": 1.96,
        "music.basic": 0.68,
        "streaming_campaign": 5.9,
        "full_production": 7.9
      }
    },
    "financialModel": {
      "type": "Reserve-Burn-Refund",
      "description": "Cost reserved before execution, burned on success, refunded on failure",
      "phases": [
        "reserve",
        "burn",
        "refund"
      ],
      "guarantees": [
        "Pre-commit pricing (know cost before execution)",
        "Hard budget guarantees",
        "No cost for provider failures"
      ]
    },
    "tierSystem": {
      "tiers": [
        {
          "id": 0,
          "name": "UNVERIFIED",
          "maxTask": 0,
          "dailyLimit": 0,
          "access": [
            "estimate"
          ]
        },
        {
          "id": 1,
          "name": "DEPOSITED",
          "maxTask": 1,
          "dailyLimit": 10,
          "access": [
            "image"
          ]
        },
        {
          "id": 2,
          "name": "ESTABLISHED",
          "maxTask": 5,
          "dailyLimit": 100,
          "access": [
            "image",
            "video",
            "music"
          ]
        },
        {
          "id": 3,
          "name": "TRUSTED",
          "maxTask": 50,
          "dailyLimit": 1000,
          "access": [
            "image",
            "video",
            "music",
            "priority"
          ]
        }
      ]
    },
    "rateLimits": {
      "byTier": {
        "0": {
          "requestsPerMinute": 10,
          "concurrentTasks": 1
        },
        "1": {
          "requestsPerMinute": 30,
          "concurrentTasks": 3
        },
        "2": {
          "requestsPerMinute": 60,
          "concurrentTasks": 10
        },
        "3": {
          "requestsPerMinute": 120,
          "concurrentTasks": 25
        }
      }
    },
    "executionPolicy": {
      "retryBehavior": "deterministic",
      "maxRetries": 3,
      "timeoutSeconds": {
        "image": 300,
        "video": 600,
        "music": 600
      },
      "refundPolicy": "full_on_failure"
    }
  },
  "securitySchemes": {
    "vapApiKey": {
      "httpAuthSecurityScheme": {
        "scheme": "Bearer",
        "bearerFormat": "vap_xxxx"
      }
    }
  },
  "security": [
    {
      "vapApiKey": []
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "execute-media-task",
      "name": "Execute Media Task",
      "description": "Executes AI media tasks with enforced budgeting, provider abstraction, and full task lifecycle tracking. Returns deterministic cost and result references.",
      "tags": [
        "execution",
        "orchestration",
        "media",
        "task",
        "autonomous-agents",
        "budget-aware"
      ],
      "examples": [
        "Execute an image task within a fixed budget",
        "Submit a media task and track its execution lifecycle",
        "Run a task with deterministic cost tracking"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "task_type": {
            "type": "string",
            "enum": [
              "image_generation",
              "video_generation",
              "music_generation"
            ],
            "description": "Type of media task to execute"
          },
          "prompt": {
            "type": "string",
            "description": "Task specification or prompt"
          },
          "constraints": {
            "type": "object",
            "description": "Execution constraints",
            "properties": {
              "max_budget": {
                "type": "number",
                "description": "Maximum budget in USD"
              },
              "preferred_aspect_ratio": {
                "type": "string",
                "enum": [
                  "1:1",
                  "16:9",
                  "9:16",
                  "4:3",
                  "3:4"
                ],
                "description": "Preferred output aspect ratio"
              },
              "quality_tier": {
                "type": "string",
                "enum": [
                  "standard",
                  "high"
                ],
                "description": "Quality tier for execution"
              }
            }
          }
        },
        "required": [
          "task_type",
          "prompt"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Unique task identifier"
          },
          "status": {
            "type": "string",
            "enum": [
              "submitted",
              "working",
              "completed",
              "failed",
              "cancelled"
            ],
            "description": "Current execution status"
          },
          "result_reference": {
            "type": "string",
            "description": "Reference to task result (when completed)"
          },
          "estimated_cost": {
            "type": "string",
            "description": "Pre-execution cost estimate in USD"
          },
          "actual_cost": {
            "type": "string",
            "description": "Post-execution actual cost in USD"
          }
        }
      }
    },
    {
      "id": "check-agent-balance",
      "name": "Check Agent Balance",
      "description": "Returns the current execution balance and spending limits for the requesting agent. Essential for budget-aware task planning.",
      "tags": [
        "financial",
        "balance",
        "budget",
        "agent-economy",
        "execution"
      ],
      "examples": [
        "Check available execution budget",
        "Query remaining balance before task submission",
        "Verify spending capacity"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "available_balance": {
            "type": "string",
            "description": "Total available balance in USD"
          },
          "reserved_balance": {
            "type": "string",
            "description": "Amount reserved for pending executions"
          },
          "usable_balance": {
            "type": "string",
            "description": "Balance available for new task submissions"
          },
          "currency": {
            "type": "string",
            "default": "USD",
            "description": "Currency code"
          }
        }
      }
    },
    {
      "id": "query-task-status",
      "name": "Query Task Status",
      "description": "Retrieves execution state, cost, and result references for a previously submitted task. Provides full lifecycle visibility.",
      "tags": [
        "task",
        "status",
        "execution",
        "lifecycle",
        "tracking"
      ],
      "examples": [
        "Query execution status for task abc-123",
        "Check if task execution is complete",
        "Retrieve final cost for completed task"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "task_id": {
            "type": "string",
            "description": "The task ID to query"
          }
        },
        "required": [
          "task_id"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Task identifier"
          },
          "status": {
            "type": "string",
            "enum": [
              "submitted",
              "working",
              "completed",
              "failed",
              "cancelled"
            ],
            "description": "Current execution status"
          },
          "result": {
            "type": "object",
            "description": "Execution result (when completed)"
          },
          "error_message": {
            "type": "string",
            "description": "Error description (when failed)"
          },
          "estimated_cost": {
            "type": "string",
            "description": "Pre-execution estimate in USD"
          },
          "actual_cost": {
            "type": "string",
            "description": "Post-execution cost in USD"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Task submission timestamp"
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Task completion timestamp"
          }
        }
      }
    },
    {
      "id": "execute-video-task",
      "name": "Execute Video Task",
      "description": "Executes AI video generation tasks using P-Video via Replicate. Requires Tier 2 (ESTABLISHED) or higher. Supports 4, 6, or 8 second videos with optional audio.",
      "tags": [
        "execution",
        "video",
        "generation",
        "p-video",
        "autonomous-agents",
        "budget-aware"
      ],
      "examples": [
        "Generate an 8-second video with audio",
        "Create a promotional video clip",
        "Execute a video task with budget constraints"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "description": "Video description including visual treatment, camera movement, and mood"
          },
          "duration": {
            "type": "integer",
            "enum": [
              4,
              6,
              8
            ],
            "default": 8,
            "description": "Video duration in seconds"
          },
          "aspect_ratio": {
            "type": "string",
            "enum": [
              "16:9",
              "9:16"
            ],
            "default": "16:9",
            "description": "Video aspect ratio"
          },
          "generate_audio": {
            "type": "boolean",
            "default": true,
            "description": "Generate audio with video (affects cost)"
          },
          "constraints": {
            "type": "object",
            "description": "Execution constraints",
            "properties": {
              "max_budget": {
                "type": "number",
                "description": "Maximum budget in USD (video: $1.96 fixed)"
              }
            }
          }
        },
        "required": [
          "prompt"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Unique task identifier"
          },
          "status": {
            "type": "string",
            "enum": [
              "submitted",
              "working",
              "completed",
              "failed",
              "cancelled"
            ],
            "description": "Current execution status"
          },
          "video_url": {
            "type": "string",
            "description": "URL to generated video (when completed)"
          },
          "estimated_cost": {
            "type": "string",
            "description": "Pre-execution cost estimate in USD"
          },
          "actual_cost": {
            "type": "string",
            "description": "Post-execution actual cost in USD"
          }
        }
      }
    },
    {
      "id": "execute-music-task",
      "name": "Execute Music Task",
      "description": "Executes AI music generation tasks using Suno AI. Generates vocal or instrumental tracks. Fixed cost: $0.68 per track.",
      "tags": [
        "execution",
        "music",
        "audio",
        "generation",
        "suno",
        "autonomous-agents",
        "budget-aware"
      ],
      "examples": [
        "Generate a 2-minute instrumental track",
        "Create a lo-fi hip hop beat",
        "Generate a folk song with vocals"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "description": "Music description including genre, mood, instruments, and tempo"
          },
          "duration": {
            "type": "integer",
            "default": 120,
            "minimum": 30,
            "maximum": 480,
            "description": "Target duration in seconds (30-480)"
          },
          "instrumental": {
            "type": "boolean",
            "default": false,
            "description": "Generate without vocals"
          },
          "constraints": {
            "type": "object",
            "description": "Execution constraints",
            "properties": {
              "max_budget": {
                "type": "number",
                "description": "Maximum budget in USD (music: $0.68 fixed)"
              }
            }
          }
        },
        "required": [
          "prompt"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "task_id": {
            "type": "string",
            "description": "Unique task identifier"
          },
          "status": {
            "type": "string",
            "enum": [
              "submitted",
              "working",
              "completed",
              "failed",
              "cancelled"
            ],
            "description": "Current execution status"
          },
          "audio_url": {
            "type": "string",
            "description": "URL to generated audio (when completed)"
          },
          "duration": {
            "type": "number",
            "description": "Actual audio duration in seconds"
          },
          "estimated_cost": {
            "type": "string",
            "description": "Pre-execution cost estimate in USD"
          },
          "actual_cost": {
            "type": "string",
            "description": "Post-execution actual cost in USD"
          }
        }
      }
    }
  ],
  "supportsExtendedAgentCard": true
}